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ABSTRACT 



This manual contains user information pertaining to the 3KC3120 
Simulator Program as well as a complete description of all user 
controls and service requests. The SKC3120 Simulator utilizes 
the facilities of the host machine to create a functional 
reproduction of the SKC3120 Computer. User controls and a 
service facility are provided to permit effective control of the 
Simulator. 

Pro;yer operation of the SKC3120 Simulator requires knov;ledge of 
the SKC3120 computer and the SKC3120 (KAL31 ) Assem.bler language. 
Therefore/ the follov/ing documents should be used in conjunction 
with the Simulator Reference Manual: 

Y2it0A301H0S10 SKC3120 Assembler Language Reference Manual 

Y2U0A30.0M0810 SKC3120 Principles of Operation 

Y2U0A301M0811 3KC3120 Assembl er/L inkage Edi tor/Simul ator 

User • s Manual . 

Since this Simulator was designed to be largely machine portable, 
it can be eas i 1 y adapted to run on a variety of host machines. 

This manual is Most Machine independent and describes the user 
control commands and service routines which may be used with any 
Host Machine. 

Specific operating instructions are supplied for the IBM 360/370 
in the liost Procedures fianual . 

Y2i^0A301H0S12 SKC3120 Host Procedures for the IBM 360/370 

Computers 
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1. INTRODUCTION 

The Singer Company, Kearfott Division has developed a powerful 
Simulator program to complement the development of the SKC3120 
Computer and the SKC3120 Macro Assembler. The program is 
executed on a host machine computer system and is intended for 
use by customers, or potential customers, who do not have an 
SKC3120 Computer System available for program checkout, or who 
desire to avail themselves of the extensive user control and 
report facilities not normally available with the SKC3120 
Computer i tsel f • 

The Simulator accepts as Input the SKC3120 Macro Assembler's load 
module, which is normally on magnetic tape. It loads this module 
into a simulated SKC3120 memory within the host machine's memory. 
The Simulator is capable of interpreting and executing SKC3120 
instructions from this simulated memory; hence, it is termed an 
interpretive Simulator. It processes each data word and all 
arithmetic and logical operations with bit-by-bit accuracy. 

The SKC3120 Simulator consists of three major parts: the SKC3120 
hardware models (Central Processing Unit (CPU), Input/Output 
(I/O), Interrupt and Memory models), a service facility, and a 
user defined FORTRAN Control Program (FCP). The FCP may be 
structured to satisfy a wide variety of user requirements and 
may, at the highest level, take the form of an operating system, 
which would represent the Simulator control and forcing function 
for the tasks to be performed. 

Simulator output files contain the configuration file, the user 
control input file and the on-line diagnostics file. Each of 
these files is formatted and printed as the normal output of the 
Simulator. 

Trace output produced by the Simulator provides information 
pertaining to the instruction location, mnemonic, operand 
address, index register, arithmetic registers and the time status 
of simulated programs. The Report Program Generator (RPG) Is used 
to format and print out this information when requested by the 
user. 

The Simulator Trace File may contain voluminous output, and 
therefore the user may wish to put the raw data on magnetic tape 
and generate the appropriate reports on another facility (e.g. an 
off line mini -computer) . To provide this mode of operation, the 
source of the RPG will be provided to facilitate Its conversion 
to the desired computer. 
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The remainder of this reference manual is divided Into three 
major parts. Sections 2 and 3 discuss Simulator capabilities and 
describe the environment In which the Simulator functions. 
Section k Is presented as a tutorial; It Is Intended to Instruct 
the user In a step-by-step manner so that he may utilize the 
simulator with the default FCP. Numerous examples are provided, 
showing typical Simulator Input control statements and the 
resultant output. Sections 5 through 7 contain all the 
Information necessary to enable a user to design and implement 
his own FCP and to construct his own Input/output model programs. 
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2. SIMULATOR CAPABILITIES 

Effectively/ the SKG3120 Simulator Is a functional reproduction 
of the SKC3120 Computer. It possesses a Central Processing Unit 
(CPU)/ Input/Output (I/O), Interrupt hardware and memory models. 

In addition, the Simulator provides control and service 
capabilities to the user who may thereby effectively and 
efficiently control the simulation process and request Simulator 
services that are essential to the successful Implementation of 
user program modules. 

The mechanism that Is employed by the user to initiate and 
complete control functions and request Simulator services Is 
termed the FORTRAN Control Program (FCP). 

Essential ly, the FCP Is a user defined FORTRAN module that has 
access to the state of the SKC3120 machine (CPU, 1/0/ interrupt 
hardware and memory) and thereby provides unlimited control 
capabilities to the Simulator user. The FCP, In the control 
sense. Is the functional equivalent of a pre-programmed Computer 
Control Unit (ecu). In addition, the FCP possesses capabilities 
not present in the physical CCU; e.g., the contents of all the 
CPU registers are accessible through the FCP but not the CCU. 

Access to the Simulator is through Control Command card images. 
Input to the Simulator via the FCP by the Host Machine FORTRAN 
1/0 processing routines. Standard FORTRAN notation is used In 
the descriptions of the data cards. The structure of FORTRAN 
records and the form of the data fields within the records are 
described to the extent required by the user to recognize the 
requirements of the data to be processed. Further explanations 
are given in those cases where there is an apparent conflict. 
Typical would be the format description requiring 'A' (character) 
format, but commentary is included requiring the input to be in 
hexadecimal. In these cases, the character string is processed 
further by an internal subroutine or function sub-program which 
converts the Input string to binary for internal representation 
by considering the input as a hexadecimal number of the specified 
length. 

The logic and decision making functions that the user would 
normally make at the CCU can be programmed Into the FCP and are 
limited only by the ingenuity of the Simulator user. 



2-1 

F4202-I 2/75 



Y?[in A^n9Moai n - ™e singer company 

Y2I^0A502M0810 ^^^ KEARFOTT DIVISION 



The Simulator provides diagnostic capabl 1 i ties that are much more 
extensive than those provided by the actual hardware. In 
addition to supervision of the operational program logic and 
arithmetic routines in the check-out phase^the Simulator also 
performs a self test on the control actions and service requests 
to validate all user activities. 

Finally/ the Simulator permits the Introduction of system 
dynamics models and provides communication links to the model S/ 
thereby providing an environment for realistic SKC3120 program 
validation. The user defined models may be simple ones, modeling 
only those factors which are considered essential , or can be as 
elaborate and accurate a representation of the actual system 
dynamics as desired. 
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3. SIMULATOR ENVIRONMENT 

The job control language requirements vary with each computer 
Installation. The user is referred to the appropriate host 
procedures manual for the JCL which Is to be used at his 
installation. 

A pictorial representation of the environment in which the 
Simulator operates is shown in the Simulator functional flow. 
Figure 3-1. This shows the resources (primary files) which are 
required by the macro assembler, the Linkage Editor and the 
simulator, and Illustrates the steps which are required to 
simulate an SKC3120 program. 

Note that the functional flow Is greatly simplified if the user 
does not require I/O models and can use the default FCP. When It 
Is necessary for the user to provide his own FCP and/or I/O 
models, it is not necessary for him to recompile and relink these 
programs each time that he executes the Simulator. Once these 
user supplied programs have been debugged, a Simulator load 
module which contains them may be saved and executed In place of 
or in addition to the default Simulator. 

Source program input card Images may be supplied on any medium 
compatible with the host machine - usually cards, magnetic tape 
or disc. The same is true for the Simulator input command 
statements, although in practice these will almost always be 
suppl led on cards. 
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k. DEFAULT FCP 
k.l DEFAULT FCP FUNCTIONS 



The default FCP/ If employed, provides a convenient mechanism by 
which the user Is able to control the simulation process. The 
capabilities present with the default FCP/ enable the user to 
simulate the SKC3120 program with a minimum effort by using 
sImple/One-1 Ine commands which are then Interpreted by the 
Simulator default FCP and acted upon In sequence. 

These extensive controls and report facilities are provided to 
permit the user to simulate the SKC3120 operational program with 
capabilities that are In addition to those normally supplied with 
the SKC3120 computer. 

The simulator iS/ in effect/ a reproduction of the SKC3120 
computer and can be divided Into three sections/ the Central 
Processor/ Memory and Input/Output . The controlling capability 
In the Simulator environment is furnished by the FORTRAN Control 
Program. 

The Default FCP enables the user to define breakpoints/ input or 
output data to memory/ establish check poIntS/ execute the 
program, load memory from the output of the Linkage/Editor/ 
define the period of the real time Interrupt/ selectively trace 
portions of the simulated program/ output messages to the trace 
file and to terminate the simulation. 

Additional control in a dynamic environment may be exercised by 
generating a user supplied FCP as discussed in Section 6. In 
general/ the default FCP supports control and service directives/ 
execution time computations/ and operational program 
Interrupt ion. More detailed dynamic control and service request 
actions/ I/O modeling/ expansion of memory and re-definition of 
the memory structure/ expansion of breakpoint list size/ more 
elaborate error handlers/ elapsed time and Instruction count 
controls are possible through user definitions of the FCP and I/O 
model programs. 
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k.2 CONTROL COMMANDS 



The medium by which the user may communicate the desired control 
and service requests to the default FCP is usually card input. 
The commands must be in a specified format. Table ^-1 lists each 
of these commands with a brief functional description, and 
indicates the section where the command is more fully described. 



The control statements for the various control and service 
requests and the required fixed formats are described in detail 
in Section ^.3. This includes examples and describes the results 
or output produced by the command. The default FCP listing 
appears in Appendix A. 



Where command statement formats are shown, the 
is used: 



following method 



1. . .5. . .10. . .15. . .20. < 
XXXXXXXX aaaa bbb, 



.25. . .30. 



35 Format. f. 
A8,1X,A8 



The numbe 
numbers 
or more o 
present 
for opera 
descr i bed 
right is 
reading 
an insigh 
processor 



rs represent car 
are the control s 
perands. Charact 
exactl y as shown 
nds which appear 

after the forma 
the FORTRAN fixed 
the command stat 
t to the Command 
s. 



d columns. Immediately 
tatement commands and, if 
ers which appear in upper 
User supplied values a 
in lower case. These 
t description. The forma 
format specification tha 
ement and is furnished to 
card handling by the 



below these 

required, one 

case must be 

re substituted 

operands are 

t shown at the 

t is used for 

give the user 

FORTRAN I/O 



Several commands require additional information which must appear 
on one or more successive input statements according to format 
specification; e.g., the $DUMP command must be followed by the 
dump region speci f icat ion(s) and a delimiter. 



In 


all cases/the 


del Imit 


:er 


as specif 


ied in 


the 


de 


scr 


i ptions 


of 


the control 


commands Is 


the 


mnemonic 


•END' 


start! 


ing 


in 


column 


1. 


An 


example 


of the 


I $DUMP 


command 1 s 


furnish 


led in 


the 


fol lowing 


statements. 























1. . .5. . .10. . .15. . .20. . .25. ..30. . .35 
$DUMP 



00000200 
00001000 



000005FF 
OOOOllCO 



END 
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TABLE k-\ 



DEFAULT FCP COMMANDS 



I Command 
+ 

$BREAK 



I Functional Description 



I Section I 



I User definition of the set of simulation I k.3.k 

I break points and related action I 

$CHECK I Request to take a checkpoint I ^.3.10 

$CHKSM I Request to calculate memory check sum I ^•3.12 

$DUMP 1 Request to dump simulated memory I ^•3.7 

I region(s) I 

$EXEC I Control to initiate or resume simulation I ^•3.2 

I at a specified program counter or at the I 

I current program counter value I 

$INPUTFX I Request to patch using 'FIX' conversion I ^. 3.1^* 

$INPUTHX I Request to patch using hex input 1 U.3.13 

$INTRPT I User definition of interrupt flag I ^^.3.9 

I (INTFLG) I 

$I0DEF I User definition of real-time clock I ^.3.8 

I interrupt number, memory speed and I 

I real-time clock period I 

$N0TE I User message I 4.3.5 

$0UTPTFX I Request to output using 'FIX' conversion I 4.3.16 

$OUTPTHX I Request to output a value in hex I U.3.15 

$RESTR I Request to restart simulation from last I 4.3.11 

I checkpoint I 

$TAPIN I Request for computer load I 4.3.1 

$TERM I Request to terminate simulation I 4.3.6 

$TRACE I User definition of trace flag (TRCFLG) I 4.3.3 

+ « + 
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TABLE k-\ 

+ 



DEFAULT FCP COMMANDS (continued) 



Command 



Functional Description 



I Section I 



$INPUTFL 

$OUTPTFL 

$SETAHX 

$SETAFX 

$SETAFL 

$SETBHX 

$SETBFX 

$SETX 

$$ETR 



Request to patch using floating Input 



I It. 3. 17 
I 



Request to output using float conversion I if. 3. 18 



Sets the A register using hex option 

Sets the A register using fix option 

Sets the A register using float option 

Sets the B register using hex option 

Sets the B register using fix option 

Sets the Index register 



I tf.3.19 

I 

I U.3.20 

I 

I 11.3.21 

I 

i If. 3. 22 

I 

I It. 3. 23 

I 

I 
Sets a selected CPU register (B1^B2^IXR) I it. 3. 25 

I 
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k.3 CONTROL COMMAND DESCRIPTIONS 

U.3.1 $TAPIN Command 



The $TAPIN (tape-in) command permits the user to request a 
computer load. This causes the Simulator to read the absolute 
load module into simulated memory. This is the normal way of 
initializing memory and corresponds to reading a perforated tape 
into the memory of an actual SKC3120 Computer. An alternate 
method for accomplishing this is via the $INPUTHX and $INPUTFX 
commands, which would correspond to entering a program into the 
SKC3120 Computer by using the switches on the CCU. Note that 
this alternate method may be viable for certain small programs, 
since it obviates the need for executing the SKC3120 Macro 
Assembler and Linkage-Editor programs. 

The format of this command statement is shown below. There are 
no operands and no additional statements are required. 

1. . .5. . .10. . .15. . .20. . .25. . .30. ..3 5 Format. . . 
$TAPIN A8 

Normally/ the $TAPIN command will appear before the first $EXEC 
command, to assure that a program is in simulated memory before 
attempting to execute it. If additional $TAP1N commands appear, 
each will cause the next segment of the absolute load module to 
be read into simulated memory. If an overlay results. It is 
transparent to the Simulator and the user must be aware that the 
overlay might affect the Command statements that follow. 
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If. 3. 2 $EXEC Command 



The $EXEC (execute)command causes the Simulator to begin 
"execution" of the program being simulated. It also allows the 
user to specify the address at which this execution is to begin 
or resume. 

The format of this command Is shown below. There is one optional 
operand. No additional statements are required. 

1... 5. ..10. ..15. ..20. ..25. ..30. ..35 Format. . . 
$EXEC loc . A8^1X,A8 

loc..... specifies the location at which execution is to 
begin or resume. If this operand is omitted, then 
simulation starts at the default program counter 
value or resumes using the current program counter 
value. 

A location must be specified as an eight digit 
hexadecimal number^right justified and padded on 
the left with zeros 

When the SimuTator reads a valid $EXEC command, processing of the 
input commands is suspended and the Simulator begins to execute 
the problem program. Execution will continue until a user 
specified breakpoint is reached (see Section k.5.k). The 

Simulator then takes the action specified by the user . The user 
is able to simulate a program with only the $TAPIN and $EXEC 
commands, but, he will not be able to exercise any control over 
the progress of the simulation, nor will he get much meaningful 
output. Operating in such a mode corresponds to loading a 
program into an actual SKC3120 Computer and executing it. 

The commands described in the following sections provide the user 
with the means of getting much more useful output from the 
Simulator and for controlling the execution of his program. 
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k.5.5 $ TRACE Command 



The $TRACE (print state of the CPU) command permits the user to 
define the setting of the trace flag, TRCFLG. 

The format of this command Is shown below. There are no 
operands/ but a second statement Is required to Indicate the 
state desired for the trace flag. 

1... 5. ..10. ..15. ..20.. .25. ..30. ..35 Format. . . 
$TRACE A8 

f II 



f specifies the value to be assigned TRCFLG 

If f =1/ tracing Is turned on. 
If f « 0/ tracing Is turned off. 

V/hen the trace option Is on (TRCFLG = 1), the Simulator will 
produce output Information for each Instruction •>-•-»- — 
executed. The RPG will use this Information to produce 
report. Table ^-11 describes the Items Included 



which Is 

a trace 

the Trace 



repurt. iduie h-ii uescrioes tne items inciuueu in tne i race 
Report. The trace feature of the Simulator should generally be 
used only for relatively short programs or for small portions of 



\ a large volume of data can be generated by 
a short amount of simulated time. The trace can be turned on and 



larger programs, since 



off by using the $BREAK command which 
U.3.if. 



Is described In Section 



A selective trace can be generated by setting a break point at 
the start of the trace area and another at the end of the trace 
area. The user can then turn trace on at the first breakpoint 
and turn it off at the second, so that each time the code to be 
traced Is entered, the tracing will be activated. 
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TABLE «*-ll TRACE REPORT HEADINGS 

OPCD Operation code mnemonic of the instruction executed, 

ILOC Instruction location counter value (hex address). 

PC Program counter value after instruction execution. 

IR Contents of the instruction register. 

SR Status register contents after execution. 

IMR interrupt mask register contents after execution. 

A A register contents after execution. 

B B register contents after execution. 

OAR Operand address register. 

XR Index register contents after execution. 

Bl Base register 1 contents after execution. 

B2 Base register 2 contents after execution. 

IXR Inactive Index register contents after execution. 

CBO Carry bit after execution. 

DATUM Contents of address specified by OAR. 

MICRO SEC. Cumulative execution time in decimal micro-seconds. 

Unless otherwi se indicated, all of the above items are printed in 
hexadecimal . 
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k.3.k $BREAK Command 



The $BREAK (break point) command permits the user to add or 
delete break points In the array BRKLST. This array contains 
zero or more program counter values at which the Simulator Is to 
take special action. The default FCP provides an array , 
sufficient for 25 break points* The user specifies each break 
point and the action associated with It. 

The format of this command Is shown below. There are no operands 
on the $BREAK statement/ but one or more break points and a 
delimiter are specified on successive statements. 

1. . .5. . .10. . . 15. . .20. . .25. . .30. . . 35 Format... 



$BREAK 

loc, 
END 



actn 



A8 

5X/A8/1X,AU 

Ai* 



loc. 



actn 



specifies the program counter value to be used as a 
break point. 

A location must be specified as an eight digit 
hexadecimal number^rlght justified and padded on 
the left with zeros 

specifies the action associated with the break point. 
The following values are permitted: 

"TERM" simulation will be terminated. 

"DLTE" Delete break point from BRKLST. 

" " FCP reads additional command statements. 

Some examples of the use of the $BREAK command are presented here 
to clarify Its function. A description of each command appears 
to the right of the command. 
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1. . .5, . .10. . .15. . .20. 

$TAPIN 

$3REAK 

00005000 
OOOOSBEi* TERM 

END 

$EXEC 00005B80 

$NOTE 

PROGRAM REACHED 5000 

$BREAK 

00005BEU DLTE 
00005C88 TERM 

END 

$EXEC 



.25. ..30. ..35 



Read in load module 
Set break points 
Read more commands 
Terminate If get to 5BE'* 

Begin execution at 5B80 
User message (see tf.3.5) 

Set break points 

Delete this addr from list 

Terminate If get to 5C88 

Continue execution at 5000 



This sequence of commands effectively breaks the program 
simulation into two parts. In the first part, the program Is 
executed from 5B80 (Its starting address) to 5000, at which time 
the Simulator stops execution at the completion of the last 
instruction before executing the instruction at 5000 and reads 
additional command statements. If the program counter had a 
valuq of 5BE'f during this time, the simulation would have been 
terminated. Assuming the program counter got to 5000, the $NOTE 
command (described In Section U.3.5) would be processed. Then 
the break point at 5BE^ would be removed from the list; either we 
no longer care If the program counter has this value or we just 
want to maintain the minimum number of entries In BRKLST. 
Finally, a break point is set to terminate the simulation at 
program counter value 5C88 and execution Is resumed where it was 
suspended. 
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if. 3. 5 $NOTE Command 



The $NOTE (message) command permits the user to transmit a 
message to the Simulator which In turn transmits It to the output 
file for documentation purposes; I.e., the message wMl be 
printed on the reports generated by the RPG. 

The format of this command Is shown below. There are no 
operands. The message Is suppl led on a second statement. 

1. . .5. . . 10. . . 15. . . 20. . . 25. . . 30. . . 35 Format... 
$N0TE A8 

message.... 20A^ 

message... specifies any string of up to 80 characters. 

An example of how this statement might be used Is Included In 
the command sequence presented In the example in Section k.3.k. 
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if.3.6 $TERM Command 



The $TERM (terminate) command permits the user to terminate the 
simulation. Often, this command Is used In conjunction with the 
$N0TE command so that the reason for termination can be specified 
In the output produced by the Simulator* Functionally, this 
command causes the same action to take place as the "TERM" 
operand used with the $BREAK command. 

The format of this command Is shown below. There are no operands 
nor any additional statements required. 

1... 5. ..10. ..15. ..20. ..25. ..30. ..35 Format. . . 
$TERM A8 

Note that the following two command sequences are equivalent. 

1. . .5. . .10. . .15. . .20. . .25. . .30. . .35 

$TAPIN 

$BREAK 

QOOOiilOO 
END 

$EXEC 0000^000 
$TERM 

1. . .5.. .10. ..15.. .20. . .25. . .30. . .35 

$TAPIN 

$BREAK 

OOOOUIOO TERM 
END 
$EXEC OOOOlfOOO 

In the first sequence, since no action Is specified with the 
break point, the FCP will read the commands following the $EXEC 
statement. The $TERM statement will cause the simulation to be 
terminated. In the second sequence the simulation will be 
terminated as soon as the break point Is reached because of the 
"TERM" action specified. 

One might wonder why the first sequence would be used, since the 
second one accomplishes the same functions with fewer statements. 
To better understand this, consider the following command 
sequence: 
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1. . .5. . .10. . .15. . .20. . .25. . .30. ..35 

$TAPIN 

$BREAK 

oooomoo 

END 

$EXEC OOOOitOOO 

$NOTE 

TEST PROGRAM REACHED LOC 1*100 

$TERM 

Observe that In this case. It Is possible to print a message 
before terminating the simulation. This would not be possible 
when the "TERM" action of a break point Is used. Another example 
of the use of this command is shown in Section tf.3.11. 
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k.5.7 $DUMP Command 



The $DUMP (list memory contents) command allows the user to dump 
one or more regions of simulated memory. 

The format of this command Is presented below. There are no 
operands on the $DUMP statement/ but one or more region 
specifications and a delimiter are specified on successive 
statements. 

1.. .5.. .10. . .15. . .20. ..25. . .30. . .35 Format. . . 

$DUMP A8 

start... stop... 5X,A8,1X,A8 

END Ak 



start. . . 

stop. . . . 

Note. 



specifies the absolute SKC3120 
of the region to be dumped 



specifies the 
the region to 



absolute SKC3120 
be dumped. 



starting address 



ending address of 



A location must be specified as an eight digit 
hexadecimal number, right justified and padded on 
the left with zeros 

Any number of region specification statements can be present. 
The starting and ending locations of each dump region may include 
SKC3120 memory of different types; e.g., LSI scratchpad and core 
memory. 'When such "memory boundaries" are crossed/ the Simulator 
service routine SDUMP takes the appropriate action. Note that 
the actual dump format will differ with different types of 
memory. 

An example of a $DUMP command follows: 



JL.. .^.. .XU...X<?...ilU. .1 

$DUMP 

00000200 0000020E 
000005FE 00000650 
OOOOOFFE 00001100 

END 
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The $DUMP command Is acted upon as soon as It Is encountered by 
the FCP. Thus a memory dump of the load module may be obtained 
by dumping the region of memory It occupies Immediately following 
the $TAPIN command. This Is one of the easiest ways of obtaining 
an SKC3120 memory dump. Of course, the $DUMP command can be 
processed after a specified break point has been reached to 
determine the contents of memory after a portion of a program has 
been executed. The command sequence shown below might be used to 
accompl Ish th I s: 

1. . .5. . .10. . .15. . .20. . .25. . .30. . .35 

$ TAP IN 

$DUMP 

00000200 000005FF 

00001000 OOOOllCO 
END 
$ BREAK 

OOOOllBC 
END 

$EXEC 00001000 
$NOTE 

PROGRAM EXECUTION COMPLETE AT LOC IIBC 
$DUMP 

00000200 000005FF 

00001000 OOOOllCO 
$TERf4 

Both $DUMP commands In the above sequence dump the same regions 
of memory, the first before the program Is executed and the 
second after It has completed execution. A comparlslon of these 
two dumps would enable the user to determine which locations had 
been changed, either Intentionally or Inadvertently, by the 
program. 
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4.3.8 $IODEF Command 



The $IODEF (real time clock definition) command allows the user 

to define the real time clock, level of Interrupt and the memory 

speed to be used In execution time computations/ and the real 
time clock period. 

The format of this command Is shown below. There are no 
operands, but a second statement Is required for specifying the 
necessary data. 

1. . .5. . .10. . .15. . .20. . .25. . .30. . .35 Format. . . 

$IODEF A8 

cl mems Irtclk I 2, IX, U, IX, 110 

cl specifies the real time clock Interrupt number (1) 

where cl Is Interpreted as 2**cl I.e. If cl=0 then 
Interrupt number Is 2**0 or 1. 

mems specifies the memory speed. The scaling of the least 

significant digit Is 10**-3 MHZ. If this value Is zero, 
no time computations are performed. 

Irtclk specifies the real time clock period In nano-seconds. 

If this statement Is used. It must appear once before the first 
$EXEC statement. If this statement does not appear anywhere In 
the command sequence, before the first $EXEC card, then default 
values will be used. 

The default values assigned are: 

mems 1228 

Irtclk 

Note that on the SKC312b Computer, the real time Interrupt 
number Is usually 1, and thus cl=0 should be specified when the 
$I0DEF command Is used. It Is recommended that the user specify 
a memory speed of zero to Inhibit time computations unless 
simulated execution time Is required; this allows the Simulator 
to operate more efficiently. 
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Use of this command is Illustrated In the following examples: 

1. . .5.. .lO.. .15. . .20. . .25.. .30. ..35 
$IODEF 
1 1750 00005000 

1.. .5. . .10. ..15. . .20. . .25. .. 30. . .35 
$IODEF 
1 00006125 

In both examples/ the real time Interrupt number Is set to 1. In 
the first example, a CPU clock period of 1.75 micro-seconds (1750 
nano-seconds) Is specified, with a 5 ms real time clock period. 
In the second example, the memory speed Is specified as so that 
no execution time computations will be performed, and the real 
time clock period Is set at 6.125 ml 1 1 I-seconds. Since no time 
computations are performed, the occurrence of the real time 
Interrupt is Inhibited. 
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if. 3.9 $INTRPT Command 



The $INTRPT (Interrupt) command permits the user to set the 
interrupt flag, INTFLG. 

The format of this statement Is shown below. There are no 
operands/ but a second statement Is required to specify the 
Interrupt flag value. 

1... 5. ..10. ..15. ..20. ..25. ..30. ..35 Format. . . 
$INTRPT A8 

Intf Ak 

Intf specifies the setting of the Interrupt flag, INTFLG, 

If Intf = 1/ Interrupt 1 Is present. 

If Intf = 2, Interrupt 2 Is present. 

If Intf = 3/ both Interrupts 1 and 2 are present. 

An example of how this command might be used to cause Interrupt 2 
to occur when the program reaches location ifCOO Is shown In the 
example which follows: 

1. . .5. . .10. . .15. . .20. . .25.. .30. . .35 

$TAPIN 

$BREAK 

OOOOiiCOO 
END 

$EXEC 0000^*800 
$INTRPT 

2 
$EXEC 

When the break point at ifCOO Is reached/ the Simulator will read 
and process the $INTRPT command/ which specifies that Interrupt 2 
Is to be set/ and will then continue execution v/here It was 
suspended. 
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Notes on the generation of Interrupts. 

Note 1: Interrupt 1 Is usually the Interrupt number assigned to 
the real time clock. Such an Interrupt will occur each time that 
the real time clock period, specified on an $I0DEF command, has 
elapsed, provided that interrupts have not been disabled by the 
program being simulated. Interrupt 1 Is the interrupt which Is 
usual ly scheduled to occur at regular time Intervals. Interrupt 
2, which Is normally the interrupt generated by the Interrupt 
status register hardware, can be generated by use of the $IODEF 
command for an application where regular occurrence of Interrupt 
2 would be meaningful. 

Note 2: The user should note the difference In specification of 
Interrupts In this command and the $I0DEF command. 

$I0DEF refers to the Interrupt as a power of two. 

$JNTRPT refers to the I nterrupt dl recti y as an integer. 

Note 3: The Interrupts generated by the commands $INTRPT and 
$IODEF make use of simulated hardware scratch pad locations 3,4,5 
and 6 as described In the SKC3120 Principles of Operation. 
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i*.3.10 $CHECK Command 



The $CHECK (check point) command permits the user to Invoke the 
checkpoint service. This wlH cause the current state of the 
program being simulated to be saved on secondary storage, so that 
It may later be recovered by using the $RESTR command. 

The format of this command Is shown below. There are no 
arguments. 

1. . .5.. .10. . .15. . .20. . .25. . .30. . .35 Format. . . 
$CHECK A8 

An example of how this command Is used In conjunction with the 
$RESTR command is shown In Section i^.3.11. 
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11.3.11 $RESTR Command 



The $RESTR (restart) command permits the user to Invoke the 
restart service. This will restart the Simulator from the 
previous checkpoint. 



There are 



no 



The format of this command Is shown below, 
arguments. 

1. . .5. . .10. . .15. . .20. . .25. . .30. . .35 Format... 
$RESTR A8 

An example of how the checkpoint and restart commands are used Is 
given below: 

1. . .5. . .10. . .15.. .20. . .25. . .30.. .35 

$TAPIN 

$CHECK 

$ BREAK 

OOOOllFO 
END 

$EXEC 00001000 
$RESTR 
$INPUTHX 

OOOOlOEJi OOOOAOOl 
END 

$EXEC 00001000 
$RESTR 
$INPUTHX 

OOOOlOEtj 0000A002 
END 

$EXEC 00001000 
$TERM 

The $CHECK command saves the state of the computer before program 
execution has begun. This Is used later by the two $RESTR 
commands to restore everything to the Initial condition. The 
problem program Is executed three times, each time with a 
different Instruction at location lOEi*. After the third 
execution/ the simulation Is terminated. 
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1^.3.12 $CHKSM Command 



The $CHKSM (check sum) command directs the Simulator to read the 
load module produced by the loader and compute a checksum^ I.e./ 
a 2's complement of the sum of the contents of all 
read-only-memory cells. In addition, the $CHKSM control 
specifies the location of a ROM cell, which will ultimately 
contain the computed checksum, and directs the Simulator to 
generate a new load module file containing the checksum 
information. 

The format of this command Is shown below. There is one 
argument. 

1. . .5. . . 10. . . 15. . .20. . . 25. . .30. . .35 Format 
$CHKSM loc... A8,1X,A8 

loc a string of 8 hexadecimal characters specifying 

the ROM location that will receive the computed 
checksum 

NOTE: The string must be left padded with zeros to fill the 8 
character field. 
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tf.3.13 $INPUTHX Command 



The $INPUTHX (Input hex) command allows the user to patch 
simulated memory with hex data. The format of this command Is 
shown below. There are no operands^ but one or more data 
specification statements and a delimiter are required. 

I..f5...10...15...20...25...30...35 Format. . . 

$INPUTHX A8 

loc data.... 5X,A8,1X,A8 

END Ak 

loc specifies the absolute SKC3120 address Into which 

the data Is to be placed. 

data.... specifies the hex data which is to be entered into 
the location specified. 

Both loc and data are eight character hexadecimal number strings 
right justified and padded on the left with zeros. An example is 
shown below to Illustrate the use of this command: 

1. . .5. . .10. ..15. . .20. . .25. . .30. . .35 
$INPUTHX 

00000200 OOOOFFFF 

000012CC OOOOAOOl 

000012E0 00008FFF 
END 

The above command would cause the following actions to take 
place: 

FFFF would be Inserted Into location 200 (constant area)/ this 
might be a constant or perhaps a flag or a mask. 

Simllarlly/ AOOl Is placed In location 12CC and 8FFF is place In 
location 12E0. 

The $INPUTHX command may appear anywhere in the command sequence. 
The Simulator acts on this command as soon as It Is encountered. 
Often, this command can be used for Inl t lal Iz Ing data before the 
program execution has begun, or for changing data or Instructions 
for a subsequent execution during the same simulation run (see 
the example In Section ^.3.11). 

The function of "this command can be likened to patching a program 
In actual SKC3120 memory via the CCU. Sometimes, a re-assembly 
can be avoided by simply patching those locations which have to 
be modified. 
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k.3.1h $1NPUTFX Command 

The $INPUTFX (Input fixed point) command allows the user to patch 
simulated memory with conversion from host machine floating point 
to target machine (SKC3120 ) fixed point with scaling. 
Ordinarily/ this command would be used for patching data; the 
$INPUTHX command would be used for patching Instructions. 

The format of this command is shown below. There are no 
operands, but one or more data specification statements and a 
delimiter are required. 

1... 5.. .10. ..15. ..20. ..25. ..30.. .35 Format. . . 

$INPUTFX A8 

loc... . data. scale. 5X, AS, IX^EIU. 7, lX,Eli|. 7 

END Ah 

loc specifies the absolute SKC3120 address into which 

the data is to be placed. This address is 
specified as an eight character hexadecimal number 
and must be padded on the left with zeros. 

data specifies the value of the data which is to be put 

into the location specified. The value is expressed 
as a decimal floating point number. 

scale specifies the scaling of the least significant bit 

(LSB) of the resulting fixed point quantity. It is 
expressed as a decimal floating point number. 

A few examples are shown below to Illustrate the use of this 
command: 

1. . .5. . .10. . .15. . .20. . .25. ..30. . .35 
$INPUTFX 

000000E4 512. 1. 

000000E5 512. k. 

000000E6 123«i5.67 17.5 

END 
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Note that the data and scale values may be supplied in either "E" 
or "F" format; the Simulator will automatically convert values 
given in "F" format to "E" format. In fact, the above command 
would appear in the command output listing as: 

1. . .5. . .10. . .15. . .20. . .25. • .30. . .35 
$INPUTFX 

OOOOOOEii 

000000E5 

000000E6 
END 



0.5120000E+03 
0.5120000E+03 
0.123if567E+05 



O.lOOOOOOE+01 
O.^OOOOOOE+01 
0.1750000E+02 



Note that in the last set of values^ some conversion error will 
have occurred. 

The above command would cause the following actions to take 
place; after processing the command/ the contents of the 
locations specified would be: 



Location 

OOOOOOEif 
000000E5 
000000E6 



Contents 

00200 
00080 
002C1 



The $INPUTFX command may appear anywhere in the command sequence. 
The Simulator acts on this command as soon as it is encountered. 
Often/ this command may be used for i ni t ial izing data before 
beginning program execution, or for modifying this data for a 
subsequent execution during the same simulation run. 

The function of this command, as the $INPUTHX command, can be 
likened to patching a program in actual SKC3120 memory via the 
ecu. Of course, this command also performs a conversion 
function, which cannot be done on the CCU. 
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U.3/15 $OUTPTHX Command 



The $OUTPTHX (output hex) command allows the user to output a 
value from simulated memory directly In hex format. 

The format of this command Is shown below. There are no 
operands, but one or more address specification statements and a 
delimiter are required. 

1. . .5. . . 10. . .15. . .20. . . 25. . . 30. . . 35 Format... 

$0UTPTHX A8 

loc 5X,A8 

END kk 

loc specifies the absolute SKC3120 address from which 

the data Is to be written. The address Is 
specified as an eight character hexadecimal number 
and must be padded on the left with zeros. 

An example will Illustrate how this command may be used. Note 
that the action Is similar to that caused by the $DUMP statement. 

1. . .5. . .10. . .15. . .20. . .25. . .30. . .35 
$OUTPTHX 

OOOOOOEO 

0000U1C8 
END 

This command will cause the contents of locations "EO" and "^108" 
to be printed In hex. It may be likened to examining the 
contents of a memory word via the CCU. 
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lf.3.1G $OUTPTFX Command 



The $OUTPTFX (output fixed point) command 
output a value from simulated memory 
machine floating point format. 



allows the user to 
and convert it to host 



The format of this command 
required, but one or more 
delimiter are needed. 



is shown below. No operands are 
address specification statements and a 



1. . .5. ..10. . .15. . .20. . .25. . .30. . . 35 Format. . . 

$0UTPTFX A8 

loc... .. scale 5X,A8, IX, Eli*. 7 

END Ai* 



1 oc ..... 



specifies the absolute SKG3120 address from which 
the data is to be written. The address is 
specified as an eight character hexadecimal number 
and must be padded on the left with zeros. 



scale. 



specifies the scaling of the least significant bit 
(LSB) of the quantity in SKC3120 simulated memory. 
It Is expressed as a decimal floating point number. 

A fev/ examples are shown below to Illustrate how this command 

might be used: 



X. . .w^. . .JLU. .. 

$OUTPTFX 

OOOOOOEIf 
000000E5 
000000E6 

END 



15. . .20. . .25. ..30. ..35 

1. 

k. 

17.5 



As with the $ I NPUTFX command/ the scale value may be si 
either "E" or "F" format; the Simulator will au: 
values specified ' "'" ' ' "-" ' 



specified in 
itomatlcal 1 y 
convert values specified In "F" format to "E" format. The above 
command would appear In the output command listing as: 



1. . .5. . .10. . .15. ..20. . .25. . .30. . .35 
$OUTPTFX 

OOOOOOElt 

000000E5 

000000E6 
END 



O.lOOOOOOE+01 
0.t»000000E + 01 
0.1750000E+02 
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Note that some minor conversion error may occur/ depending on the 
value Input. 

The table below shows the hex contents of the locations specified 
and the corresponding real values v/hlch are output by 
the Simulator: 

Location Hex value Real value Scale 

OOOOOOEif 00200 0. 5120000E + 03 0, lOOOOOOE + 01 

000000E5 00080 0. 5120000E + 03 0. t*000000E + 01 

000000E6 002C1 0. 123lf567E+05 0. 1750000E + 02 

The $OUTPTFX command may appear anywhere In the command sequence. 
The Simulator acts on this command as soon as It Is encountered. 
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i*.3.17 $li>IPUTFL Command 



The $INPUTFL (Input floating point) command allows the user to 
patch simulated memory with conversion from host machine floating 
point to target machine (SKC3120 ) floating point. 

The format of this command is shown belov/. There are no 
operands, but one or more data specification statements and a 
delimiter are required. 

1... 5. ..10. ..15. ..20. •.25. ..30. ..35.. Format. . . 

$INPUTFL A8 

loc data 5X, A8, 1X,D22. 

END Ak 

loc specifies the absolute SKC3120 address of the first 

word of the double word, into which the datum is to 
be placed. This address is specified as an eight 
character hexadecimal number and must be padded on 
the left vyith zeros. 

data..... specifies the double precision value of the datum. 
The value is expressed as a decimal floating point 
number. 

A few examples are shovm below to illustrate the use of this 
command: 

1... 5. ..10. ..15. ..20. ..25. ..30. ..35.. 
$1NPUTFL 

OOOOOOEii 51.2E+01 

000000E6 512. 

000000E8 123i^567D-2 

END 

Note that the data values may be supplied in "D", ''E*', or "F" 
format; the simulator will automatically convert values given in 
'*D" or "F" format to V'E" format. However, the decimal number 
must be be right-justified in the 22 character field. The above 
command v^ould appear in the command output listing as: 

X...«^...JlU...x«/...ZU...Z>Z)...<w)U. ..«/■?.. 

$INPUTFL 

OOOOOOEii 0.512000000000000D 03 
000000E6 "0.5120000000000000 03 

OO000OE8 o.iasiiseyooooooooD 05 

END 
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The above command would cause the following actions to take 
place; after processing the command, the contents of the 
locations specified would be: 

ADDR HEX HEX REAL 

0.5120000E+02 
0.5120000E+03 
0.123i^567E+07 



The $INPUTFL command may appear anywhere in the command sequence. 
The simulator acts on this command as soon as it is encountered. 
Often, this command may be used for initializing data before 
beginning program execution, or for modifying this data for a 
subsequent execution during the same simulation run. 



OOOOOOEI+ 


6686 


6666 


000000E6 


008A 


tjOOO 


000000E8 


1C95 


ItBSA 
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I*. 3. 10 $OUTPTFL Command 



The $OUTPTFL (output floating point) command allows the user to 
output an SKC3120 double precision value from simulated memory 
and convert it to host format. 

The format of this command is shown below. No operands are 
required, but one or more address specification statements and a 
delimiter are needed. 

1...5...10...15.f.20...25...30...35 Format. . . 

$OUTPTFL A8 

loc. .... 5X,A8 

END Ak 

loc..... specifies the absolute SKC3120 address of the first 
word of the double precision floating point datum. 
This address is specified as an eight character 
hexadecimal number and must be padded on the left 
with zeros. 

A few examples are shown below to illustrate how this command 
might be used: 

1.. .5. . .10. ..15. ..20.. .25. ..30. ..3 5 
$OUTPTFL 

OOOOOOEi+ 

000000E5 

000000E8 
END 

The table belov/ shows the hex contents of the locations specified 
and the corresponding floating point values which are output by 
the simulator: 

ADDR HEX HEX REAL 

0.5120000E+02 
0.5120000E+03 
0.123t[567E + 07 



The $0UTPTFL command may appear anywhere in the command sequence. 
The simulator acts on this command as soon as it is encountered. 



OOOOOOEU 


6686 


6666 


000000E6 


008A 


itOOO 


000000E8 


1C95 


l^BSA 
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if,3.19 $SETAHX Command 



The $3ETAilX (set A registervvlth hex input) command allov/s the 
user to set the A register to an input value. 

The format of this command is shown belov/. There are no 
operands, but one data specification statement is required. 

1. . .5. . .10. . .15. .f20. . .25. . .30.. .35 Format... 
$SETAHX A8 

data. . . . 5X,A8 

data.... specifies the value to insert in the A register. 

The data is specified as an eight character 

hexadecimal number and must be padded on the left 
with zeros. 

An example will illustrate how this command may be used. Note 
The A register will be set to U1C8. 

1. . .5. . .10. . .15. . .20. ..25. . .30. . . 35 
$SETAHX 

0000U1C8 
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If. 3. 20 $SETAFX Command 



The $SETAFX (set A register fixed point input) command allows the 
user to set the A register to an input value. 

The format of this command is shown below. There are no 
operands/ but one data specification statement is required. 

1. . .5. ..10.. .15. ..20. ..25... 30. ..35 Format. . . 

$SETAFX A8 

data scale 5X/Elif . 7, IX^Eli*. 7 

END Ak 

data..... specifies the value of the data which is to be put 
into the A register. The value is expressed as a 
decimal floating point number. 

scale specifies the scaling of the least significant bit 

(LSB) of the resulting fixed point quantity. It is 
expressed as a decimal floating point number. 

A few examples are shown below to illustrate how this command 
might be used : 

JL...«i)...JLv/...JL«^...4iU...^«)...J^U...^j' 

$SETAFX 

U5. .005if932 

As with the $INPUTFX command, the scale value may be specified in 
either *'E" or "F" format; the simulator will automatically 
convert values specified in "F" format to "E" format. The above 
command would appear in the output command listing as: 

1. . .5. ..10. . .15. . .20. . .25. . .30. . .35 
$SETA 

HEX REAL SCALE 

00002000 0.i*500000E + 02 0. 5if93201E + 020E+01 



The $SETAFX command may appear anywhere in the command sequence. 
The simulator acts on this command as soon as it is encountered. 
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1^.3 .21 $SETAFL Command 

The $SETAFL (set AB register to floating point value) command 
allows the user to set the AB registers to an input value. 

The format of this command is shown below. There are no 
operands^ but one data specification statement is required. 



1. . .5. . . 10. . . 15. . .20. . . 25. . . 30. . . 35 Format... 
$SETAFL A8 

data. ... 5X,D22.0 

data.... specifies the double precision floating point data. 
Note that the data values may be supplied in "D", 
"E", or "F" format; the simulator will 
automatically convert values given in "D" or "F" 
format to "E" format. However, the decimal number 
must be right-justified in the 22 character field. 

A few examples are shown belov^ to illustrate how this command 
might be used: 

1. ..5... 10... 15... 20. ..25... 30... 35 
$SETAFL 

32767 
$SETAFL 

32767D03 



The table belov/ shows the hex contents of the register and the 
corresponding floating point values which are input to the 
simulator: 

$SETA 

HEX (A) Hex (B) Real 

00007FFF 0000008F 0. 3276700E+05 
$3ETA 

HEX (A) Hex (B) Real 

00007CFF 00000699 0. 3276699E+08 

The $SETAFL command may appear anywhere in the command sequence. 
The simulator acts on this command as soon as it is encountered. 
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i|.3. 22 $SETBHX Command 



The $SETBHX (set 
to the $SETAHX 



) register from 
command except 



hex input) 
that the B 



command is identical 
register receives the 



result of 
command. 



the conversion, 



Refer to Section «*.3.19^ $SETAHX 



If. 3. 23 $SETBFX Command 



The $SETBFX (set 3 register from a fixed point input) command is 
identical to the $SETAFX command except that the B register 
receives the result of the conversion. Refer to Section if. 3. 20, 
$SETAFX command. 



if.3.2if $SETX Command 



The $SETX (set XR register from a hex input) command is identical 
to the $SETAHX command except that the XR register receives the 
result of the conversion. Refer to Section if. 3. 19, $SETAHX 
command. 
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U.3.25 $SETR Command 



The $SETR (set base or inactive Index register from hex Input) 
command allows the user to select a register and to set the 
specified CPU register (I.e. Base register 1, 1, or the Inactive 
Index register). The value Is Input In Hex. 

The format of this command Is shown below. There are no 
operands/ but one or more data specification statements and a 
delimiter are required. 

1. . .5. . . 10. . . 15. . . 20. . . 25. . . 30. . . 35 Format... 
$SETR A8 

rg data 5X/ I2/1X/A8 



rg 



specifies the register Into which the data Is 
to be placed. Register specification Is shown 
below. 



Reg (rg) I Interpretation 



, •- + 



3 

5 



I Base register one selection 

I 

I Base register two selection 

I 

I Inactive Index register selection 



+ + 

data.... specifies the hex data which Is to be entered Into 
the location specified. The data Is specified as 
an eight character hexadecimal number and must be 
padded on the left with zeros. 

An example Is shown below to Illustrate the use of this command: 

1.. .5.. .10. . .15.. .20. . .25.. .30... 35 
$SETR 

03 0000789A 

The Simulator will output the following. 

$SETR 



REG 
Bl 



HEX 
0000789A 



The $SETR command may appear anywhere In the command sequence. 
The simulator acts on this command as soon as It Is encountered. 
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5. FCP ENVIRONMENT SPECIFICATIONS 

The Simulator provides to the FORTRAN Control Program (FCP) an 
Interface/ which Is termed Labeled Common Control Blocks. 
Essentially, the control blocks are employed In the transmission 
of the state of the machine to the FCP, which may thereby 
dynamically control the simulation process and request various 
Simulator services. The control and service actions performed by 
the FCP are operative in response to any normal or abnormal 
condition as diagnosed by the Simulator. 

The following control blocks are discussed in the sections which 
f o 1 1 ow : 

Symbol Description Section 

CPU CPU state 5.1 

10 Input/output model linkage 5.2 

ME^40RY Simulated memory definition 5.3 

lODEF Memory speed, real -time clock 5.4 

interrupt number and period 

BLIST Break point 1 1st 5.5 
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5.1 CPU CONTROL BLOCK 

The CPU control block provides to the user the state of the CPU 
and permits the user to examine and change its state, and to 
initiate and complete various control functions. The information 
content of the block is presented in Table 5-1. 

Examination and/or modification of the CPU registers may be 
performed directly by the FCP or indirectly by service requests. 
The services - SSETA, SSETB, SSETX, SMEMRY, that may be invoked 
for A, B, PC, OAR or XR register access are described in Section 
6.5/ FCP Service Requests. 

The error indicator, ERRFLG, is set by the Simulator to indicate 
that the Simulator has diagnosed a user error. The user error 
may have resulted from faulty program logic or from invalid user 
control and service request actions. Table 5-11 presents the 
complete set of diagnostics provided by the Simulator. This 
table is divided Into two parts, the first for program logic or 
arithmetic errors and the second for service request errors. 

The Interrupt flag, INTFLG, may be employed by the user to 
initiate interrupts. The Simulator, based upon the state of the 
interrupt hardware, will queue, initiate if possible, and unqueue 
the interrupts. The state of the Interrupt hardware is 
determined by the SR, IMR, and active and pending interrupt 
1 ists. 

The SR, IMR and Interrupt trap and save locations are accessible 
to the user. The INTFLG values are presented In Table 5-1. 

The trace flag, TRCFLG, may be employed by the user to turn 
tracing on or off as a function of any abnormal or normal 
condition. The TRCFLG settings are also Included In Table 5-1. 

The termination flag, TRMFLG, may be employed by the user to 
terminate the simulation as a function of any condition. Again, 
its values are presented in Table 5-1. 
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TABLE 5- 

1- ^M«^^« 


1 CPU ( 


:ONTROL BLOCK 




1 Word 


1 Symbol 


Description 


Init Value 


1 1 


A 


A register 





1 2 


B 


B register 


1 


1 3 


PC 


Pointer to next instruction 


Jt096 


1 1^ 


PCOLD 


Pointer to last Instruction 


Ij096 


1 5 


C 


C regl ster 





1 6 


1 D 


D register 





1 7 


CBO 


Carry bit 





1 8 


1 OAR 


Pointer to datum 


1 


1 9 


iR 


Instruction Register 





1 10 


SR 


Status Register 





1 11 


IMR 


Interrupt Mask Register 





1 12 


XR 


index register 





1 13 


PSU(3) 


3 spare 





1 15 


1 81 


base regi ster one 





1 17 


1 B2 


base register two 





1 18 


1 IXR 


Inactive Index register 


1 


1 19 


PSU2(57) 


57 spare 





1 76 


SWR 


Datum 





1 77 


1 TIME(2) 


Elapsed time (sec and nsec) 


1 


1 79 


1 ERRFLG 


1 Error indicator 
1 (see Table 5-1 1 ) 


1 


1 80 


INTFLG 


Interrupt flag 

= no Interrupts 

1 = level 1 interrupt 

2 = level 2 interrupt 

3 * level 1 & 2 interrupts 





1 81 


TRCFLG 


Trace flag 

= trace off 

1 = trace on 





1 82 


TRMFLG 


Termination flag 

= no termination 

1 = termination 
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TABLE 5-1 



SIMULATOR DIAGNOSTICS 



I 



ERRFLG I Interpretation I Service 

I No error 

h I Fixed point overflow 

8 I Floating point overflow 

12 I Floating point underflow 

20 I Fixed point divide check 

2h I Floating point normalization 

28 I Storage protect 

32 I Addressabil ity (PC) 

Addressability (OAR) 

kk I Illegal instruction 

^8 I Invalid device code (I/O) 

52 I Device not connected (I/O) 

200 



I Action 

Normal 

A = result 
A = result 
A = result 

NOP 

A, B = 

No store 

NOP 

NOP 

NOP 

No I/O oper 

No I/O oper 



20U 



208 



212 



I nval id array s ize 



Undefined symbol 



I nval id address 



216 



Invalid conversion (FIX) 
(-2**16 LT X LT 2**16-1) 



Invalid conversion (FLT) 
.1^^693670-38 LE R(host) 
LE .3it02823D39 

I nval id CPU register 
(Bl, B2^ IXR) selection 



1 SDUMP 


FOP return 


1 S INPUT 


FCP return 


1 SOUTPT 


FCP return 


1 STABLE 

1 


FCP return 


1 SDUMP 


Next region 


1 SINPUT 


1 FCP return 


1 SOUTPT 


1 FCP return 


1 STABLE 

1 


1 Next symbol 


1 SDUMP 


1 Next region 


1 SINPUT 


1 FCP return 


1 SOUTPT 


1 TCP return 


1 STABLE 

1 


1 Next addr. 


1 SINPUT 


1 No convert 


1 SSETA 


1 No convert 


1 SSETB 

1 


! No convert 


1 SINPUT 


1 No convert 


1 SSETA 
1 


i No convert 


1 

1 SSETR 
1 


1 FCP return 
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5.2 10 CONTROL BLOCK 



The Simulator permits the user to introduce models of external 
devices for the purpose of dynamic simulation. The Simulator 
provides the necessary 1 Inkage between Itself and the models, and 
transmits the Information content of the I/O Instruction via the 
10 control block. The Information content of the 10 control 
block Is presented In Table 5-111/ and represents the state of 
the I/O section of the Simulator. 

The type of Instruction that Is being executed Is determined by 
the INOUT flag setting. DMA operations may be accomplished by 
the services SINPUT and SOUTPT/ which are described in Sections 
6.5.3 and 6.5.^, respectively. 



TABLE 5-1 I I 10 CONTROL BLOCK 



I Word I Symbol I Description 



I Init Value I 



1 1 


1 LFLAG 




Not used 1 


1 2 


1 COMMND 




Not used 1 


I 3 


1 ACK 




Acknowledge bit 1 


1 k 


1 TMEDLY 




Time delay 1 


1 5 


1 INOUT 




Input or output operation 1 




1 




1 = input 1 




1 




= output 1 


1 6 


1 LOC 




Not used 1 


1 7 


1 DATA 




Not used 1 


1 8 


1 DC 




Device code 1 
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5.3 MEMORY CONTROL BLOCK 

The MEMORY control block may be employed by the user to override 
the default memory size of 16K words. The size of the memory 
model Is specified by the dimension of the SIMMEM array. The 
width of the memory is one full -word of the host machine, which 
Is suff Icientl y large to accommodate the prescribed word lengths 
of the simulated SKC3120 Computer. Table 5-IV presents the 
information content of the MEMORY control block. 



TABLE 5- IV MEMORY CONTROL BLOCK 

+ - ' + 

I Word I Symbol I Description I Initial Value I 

+ . + 

I N* I SIMMEM(N) I Simulated memory I HLT's ** \ 

+ -.- • « + 

* N ranges from 1 to 1638'i 

** The initialization pattern Is embedded In the Simulator 
Configuration File and Is normally set to the •HLT' Instruction 
code. 

See Host Procedures Manual for selection of the appropriate 
Simulator Configuration File. The format of the Simulator 
Configuration File Is described In the Assembler Linkage/Editor 
Simulator Users Manual. 
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5. it lODEF CONTROL BLOCK 



The lODEF control block may be employed by the user to Initialize 
the real time clock period and to specify the CPU clock period 
for instruction execution time computations. IRTCLK may be set 
to any integer value, where the least significant digit has a 
value of one nano-second. This serves as the basis by which the 
Simulator will initiate real-time Interrupts. MEMSPD may be set 
to specify the CPU clock period, where the least significant 
digit scale factor is 10**-3 MHZ. The default value of 0, if not 
overridden, indicates that a no-timing option is selected. The 
information content of this control block is presented In Table 
5-V. The lODEF control block must be initialized before the 
first instruction is executed or the default values will be used 
throughout the run. 



TABLE 5-V lODEF CONTROL BLOCK 

+ , , + 

I VJord 1 Symbol I Description I Initial Value I 

+ . ^ .- . , . . . + 

I II IRTCLK I Real-time clock period I I 

I 2 I MEt4SPD I CPU clock period I 1228 I 
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5.5 BUST CONTROL BLOCK 



The BLIST control block consists of the array BRKLST with a 
default length of 25 words. This control block may be employed 
by the user to define a set of simulation break points, SKC3120 
absolute addresses at which control will be returned to the FCP. 
The Information content of the BLIST control block Is shown In 
Table 5-VI. 

This list may not exceed the 25 words allocated If the default 
FCP Is used. The default FCP maintains a count of the break 
points In use and passes the count to the Simulator as Argument 1 
of subroutine 'CONTRL' (see section 6.1). 

If the user generated FCP Is used. Argument 1 of 'CONTRL* must be 
updated each time the break point list changes. The user may 
also change the number of locations allocated In the BLIST 
control block, as Indicated In TABLE 5-VI. 



The Simulator can be made 
passed to BLIST control 
driver, assembled vnth the 
Instances, there would be 



to respond to symbolic references 

block from a KAL31 Assembler languge 

program being simulated. In some 

an advantage In using this method over 



the absolute addressing 
it Is used directly. 



required by the BLIST control block when 



TABLE 5-VI BLIST CONTROL BLOCK 



I Word I Symbol 



I Description 



I Initial Value I 



25 



BRKLST(l) 



BRKLST(25) 



3RKLST(N) 



PC break point 
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6 FCP LANGUAGE SPECIFICATIONS 

The FORTRAN Control Program (FCP) must consist of a set of 
FORTRAN (or FORTRAN compatible) statements. The language and 
associated rules must coincide with the level of FORTRAN chosen 
by the user. The Simulator requires that the FCP be written as a 
subroutine and must include linkage and calling sequences^ type 
declarations and allocation of common blocks as described in the 
follov/ing paragraphs. 

6.1 FCP SUBROUTINE LINKAGE AND CALLING SEQUENCES 



The name of the FCP must be "CONTRL". The format of the FORTRAN 
subroutine statement is: 

1. . .5. . .10. . .15.. .20. . .25. . .30. . .35. ..UO. . .'*5. ..50. ..55. ..60 
SUBROUTINE CONTRL (ARGl, ARG2, ARG3^ ARGif ) 

ARGl is a fixed point quantity which is output from the 
FCP and specifies the number of user defined active 
break points. The BRKLST array in the BLIST 
control block must be at least as large as this 
value. I f ARG 1 = 0, then the user desires to 
single step through the simulat ion process; i.e., 
control vn 1 1 be returned to the FCP after each 
instruction execution. 

ARG2 is a fixed point quantity which is output from the 
FCP and specifies the elapsed time at which control 
should be returned to the FCP. The least 
significant bit (LSB) has a value of one 
micro-second. If ARG 2=0, the function is 
ignored. i.e. Elapsed time does not cause the 
Simulator to return control to the FCP. 

ARG3 is a fixed point quant i tywh ich i s output from the 
FCP and specifies the count of instructions after 
which control is returned to the FCP. I f ARG 3 = 0, 
the function is ignored. i.e. Instruction count 
does not cause the Simulator to return control to 
the FCP. 
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ARG4 IS a fixed point quantity which is input to the FCP 

and is set by the Simulator to indicate the 

condition that caused control to be transferred to 
the FCP. 

The calling sequence^ with the exception of ARGU/ is user 
defined, as part of the FCP, and specifies the size of the break 
point list and the instruction count or elapsed time after which 
control will be returned to the FCP. 

All arguments have an initial value of except ARCi., which has 
an initial value of 16. This allows the user to define or 
initialize the Simulator control blocks before starting to 
simulate the problem program , by comparing the value of the 
arguments and then initializing if equal to zero or processing if 
not equal to zero. If the FCP is written to read an input file 
during initialization, external control can be exercised over 
arguments 1,2 and 3 which are then passed to the Simulator from 
the FCP control program. 

If the Simulator diagnoses a user operational program logic or 
arithmetic error, control will be returned unconditionally to the 
FCP. This permits the user to define error handlers for all of 
the settings of ERRFLG, as presented in Table 5-11. 



The condi t ion 

indicates the 

to the FCP. The ARG^f 



ndicator, ARGU, which is set by the Simulator, 
reason for transfer of control from the Simulator 
settings are presented in Table 6-1. 



TABLE 6-1 ARGi* SETTINGS 



+ 

I 
• + 



I ARGii Value I Interpretation 



2**0 = 1 I Error condition (defined by ERRFLG) 

2**1 =2 I Real-time interrupt 

2**2 = h I Elapsed time interrupt 

2**3 = 8 I Instruction count interrupt 

2**4 = 16 I Break point interrupt 



It is possible that several bits of ARG^^ are set to indicate 
multiple conditions; e.g., a value of 5 (2**2 + 2**0) v^ould 
indicate both an error condition and the presence of an elapsed 
time interrupt. 
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6.2 TYPE DECLARATION 



All Information transmitted to/from the FCP via the control 
blocks described In Section 3 must be Integer full words. Hence^ 
an IMPLICIT statement or explicit INTEGER statements for each 
variable must be present. The IMPLICIT statement format is: 

1. • .5.. .lO* . .15. • .20. . .25.. .30. ..35. . .«*0. ..U5. . .50. ..55. ..60 
IMPLICIT INTEGER (A-Z) 

See the listing of the Default FCP program In Appendix A. 
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6.3 CONTROL BLOCKS 



Areas must be defined for Labeled Common I O^CPU,BLI ST, lODEF and 
MEMORY as shown In the listing of the Default FCP program in 
Appendix A. 

A typical definition statement follows: 

1. . .5. ..10. ..15. ..20. ..25. ..30.. .35. .. 1*0. ..1*5... 50. ..55... 60 
£OMMON/IO/LFLAG,COMMND,ACK,TMEDLY, INCUT, LOG, DATA, DC 



6-l» 

F4202-I 2/76 



THE SINGER COMPANY 
KEARFOTT DIVISION 



Y2l^0A302M0810 



REV, 



6.U CONTROL FUNCTIONS 



The control functions that may be dynamically performed by the 
FCP are numerous and varied. A partial list is presented in 
Table 6-11. All functions are operative in response to the 
normal and abnormal conditions specified In Section 5. 



TABLE 6-1 I 



FCP CONTROL FUNCTIONS 



I 



I 
■ + 



Control Function 



I Associated Mechanism 



.Multiple break points 

Single step 

Multiple starting points 

Masking and unmasking 

Interruption 

Tracing (on/off) 

Termination 

Error handlers 

Memory definition and size 

Initiate DMA operations 

Initiate I/O via A register 



/BLIST/ BRKLST 

CONTRL calling sequence 

/CPU/ PC 

/CPU/ SR, IMR 

/CPU/ INTFLG 

/CPU/ TRCFLG 

/CPU/ TRMFLG 

/CPU/ ERRFLG 

/MEMORY/ SIMMEM 

/MEMORY/SINPUT^SOUTPUT * 

/lO/ INOUT^SDVICE * 



*SINPUT,SOUTPUT and SDVICE may be 
of data to and from the KAL31 
simulated. 



used to simulate the transfer 
Assembly language program being 
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6.5 FCP SERVICE REQUESTS 

The Simulator services that are provided are listed 
alphabetically In Table 6-III. This table also Indicates In 
which section each service request is described* The linkage 
conventions that must be observed are presented in succeeding 
sections. All service requests may be Issued in response to any 
normal or abnormal conditions as diagnosed by the Simulator. 

5.5.1 STRACE REQUEST 



The STRACE request may be Issued by the FCP. The service 
supplied by the Simulator is to record the state of the CPU/ 
Including elapsed time, at the point in the Simulation where 
the call was made. The format of the FORTRAN statement Is shown 
below; there are no arguments. 

1. ..5. . .10. . .15. . .20. . .25. ..30. . .35. . .ifO. . .tf5. ..50. . .55. ..60 
CALL STRACE 

Tracing may also be controlled by setting TRCFLG, as described in 
Section 5.1, 

When the trace option Is on (TRCFLG = 1), the Simulator will 
produce output Information for each Instruction which is 
executed. The RP6 will use this Information to produce a trace 
report. Table if-l I describes the I terns included In the Trace 
Report. The trace feature of the Simulator should generally be 
used only for relatively short programs or for small portions of 
larger programs, since a large volume of data can be generated by 
a short amount of simulated time. The trace can be turned on and 
off at successive break points. 

A selective trace can be generated by setting a break point at 
the start of the trace area and another at the end of the trace 
area. The user can then turn trace on at the first breakpoint 
and turn It off at the second, so that each time the code to be 
traced Is entered, the tracing wi 1 1 be activated. 
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TABLE 6-11 I 



SIMULATOR SERVICES 



I Service I 

+ — 

I SCHECK 

I 

I SDUMP 

I 

I 

I SDVICE 

! 

I 

I 

I S INPUT 

I 



Function 

Records state of SKC3120 machine 

Transmits data from specified memory 
regions 

Defines the data to appear on the I/O 
interface when the appropriate input 
instruction is executed 

Transmits data to selected memory 
locations under format control 

Logically connects an I/O device code to 
the name of a subroutine to be invoked 
when data is transmitted on that channel 

Determines a symbol's value 

Transmits a user defined message 

Transmits data from selected memory 
locations under format control 

Restarts simulation from last checkpoint 

Sets the A register under format control 

Sets the B register under format control 

Sets the index register 

Sets a selected CPU register (B1,B2^IXR) 

Determines value of an array of symbols 

Performs a computer load 

Records state of the CPU 



I Section I 



SIO 



I SMEMRY 



I SNOTE 

I 

I SOUTPT 

I 



I SRESTR 

I 

I SSETA 

I 

I SSETB 

I 

I SSETX 

I 

I SSETR 

I 

I STABLE 



I STAPIN 

I 

I STRACE 



6.5.11 
6.5.2 

6.5.5 

6.5.3 
6.5.6 

6.5.7 

6.5.14 

6.5.1* 

6.5.12 

6.5.8 

6.5. £ 

6.5.10 

6.5.16 

6.5.15 

6.5.13 

6.5.1 
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6.5.2 SDUMP REQUEST 



VJhen the SDUMP request Is 

provided by the Simulator 

regions of memory specified 

stopping locations (dump 

symbolically or absolutely. 

setting of the ERRFLG Indicator are specified In 

format of the FORTRAN statement Is shown below: 



Issued by the user, the service 

Is to record the contents of the 

by the user. The starting and 

regions) may be specified either 

The Simulator diagnostic action and 

Table 5-1 I. The 



1. . .5. . .10. . .15. ..20. . .25. ..30. . .35. ..UO. ..i*5. ..50. ..55. ..60 
CALL SDUMP (ARGl,ARG2,AR63,ARGlf) 



ARGl 



ARG2 



Is a fixed point quantity and specifies 
ARG4 aripay sizes. 



the ARG3 and 



ARG3 



ARG4 



Is a double-word character string (8 characters) and 
specifies the deckname if the symbolic referencing 
option Is selected. If ARG2 = "NODECK ", absolute 
addressing Is selected. 

Is a fixed point or character string array which 
specifies the dump starting locations. 

is a fixed point or character string array which 
specifies the dump ending locations. 



If absolute addressing is selected/ then ARG3 and ARGtf must be 
single subscripted arrays of dimension (ARGl) and must contain 
fixed point absolute SKC3120 addresses. If symbolic referencing 
is selected/ then ARG3 and ARG^f must be double subscripted arrays 
of dimension (if/ARGl)/ and all symbols must be left-justified and 
padded with blanks on the right. 

The starting and ending locations of each dump region may include 
SKC3120 memory of different types; e.g./ LSI scratchpad and core 
memory. V^hen such "memory boundaries" are crossed/ the Simulator 
service routine SDUMP takes the appropriate action. Note that 
the actual dump format will differ with different types of 
memory. 
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6.5.3 SINPUT REQUEST 



The SINPUT request may be issued by the FCP and the service 
supplied by the Simulator Is to Input (under format control) Into 
memory and record the results of the service operation. The 
input starting location may be defined symbolically or 
absolutely. The type of conversions may be none or host machine 
floating to SKC3120 fixed point. The Simulator diagnostic 
action and setting of the ERRFLG Indicator are specified in Table 
5-11. The format of the FORTRAN statement is: 

1. . .5.. .10.. .15. . .20. . .25. . •30.. .35. • .40. ..i*5. .f50.. .55. . .60 
CALL SINPUT (ARG1^ARG2^ARG3,ARG4,ARG5^ARG6) 

ARGl is a ful 1 -word character string and specifies the 
type of ' conversion desired. The following values 
are permitted: 

"HEX " No conversion; ARG5 must be an array of 
fixed point quantities. 

"FIX " ARG5 and ARG6 must be arrays of host machine 
floating point quantities; the ARG6 array 
represents the scale factors of the LSB's of 
the resulting fixed point quantities. 

"FLT " ARG5 must be a double precision floating 
point quantity. VJhen "FLT " option is 
specified, the conversion is from host 
machine floating point to SKC3120 floating 
point. 

ARG2 is a double-word character string (8 characters) and 
gives the deckname if symbolic addressing Is being 
used. If ARG2 = "NODECK ", absolute addressing is 
used. 

ARG3 is a fixed point word or character string and 
specifies the input memory starting location. 

ARG4 is a fixed point quantity and specifies the ARG5 
and ARG6 array sizes. 

ARG5 is a floating or fixed point array of values to 
Input. 

ARG6 Is a floating point array of scale factors and is 
required only for conversion from host machine 
floating point to SKC3120 fixed point. 
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If absolute addressing Is selected^ then ARG3 must be a fixed 
point scalar and contain an absolute SKC3120 address. If 
symbolic referencing Is selected^ then ARG3 must be a single 
subscripted array of dimension ik) . All symbols must be 
left-justified and padded with blanks on the right. 
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B.S.k SOUTPT REQUEST 



The SOUTPT request may be issued by the FCP and the service 
supplied by the Simulator is to output (under format control) 
from memory and record the results of the service operation. The 
output starting location may be defined symbolically or 
absolutely. The type of conversion may be none or SKC5120 fixed 
point to host machine floating point. The Simulator diagnostic 
action and setting of the ERRFLG Indicator are specified in Table 
5-11. The format of the FORTRAN statement Is: 

1. . .5. . .10. . .15. ..20. ..25. . .30. ..35. ..UO. ..U5. ..50. ..55. . .60 
CALL SOUTPT (ARGl, ARG2^ ARG3, ARGU, ARG5, ARG6) 

ARGl is a full-word character string and specifies the 
type of ' conversion desired. The following values 
are permitted: 

"HEX " No conversion; ARG5 must be an array of 
fixed point quantities. 

"FIX " ARG5 and ARG6 must be arrays of host machine 
floating point quantities; the ARG6 array 
represents the scale factors of the LSB's of 
the fixed point quantities to be output. 

"FLT " ARG5 must be a double precision floating 
point quantity. When "FLT " option is 
specified/ the conversion Is from host 
machine floating point to SKC3120 floating 
point. 

ARG2 is a double-word character string (8 characters) and 
specifies the deckname if symbolic addressing is to 
be used; if ARG2 = "NODECK "^ absolute addressing 
Is to be used. 

ARG3 Is a fixed point or character string array specifying 
the input memory starting location. 

ARGU Is a fixed point quantity and specifies the ARG5 and 
ARG6 array s izes. 
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ARG5 is a fixed or floating point array which will receive 
the quantities from memory. 

ARG6 is a floating point array of scale factors and is 
required only for conversion from SKC3120 fixed 
point to host machine floating point. 

If absolute addressing is selected, then ARG3 must be a fixed 
point scalar and contain an absolute SKC3120 address. If 
symbol ic referencing is selected, then ARG3 must be a single 
subscripted array of dimension ih). All symbols must be 
left-justified and padded with blanks on the right. 
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6.5.5 SDVICE REQUEST 



The SDVICE request may be Issued by the FCP and the service 
supplied by the Simulator Is to transfer one data word to the A 
register. This service permits the user to execute closed-loop 
simulations without providing sophisticated models of external 
devices. The Simulator diagnostic action and setting of the 
ERRFLG Indicator are specified In Table 5-M. The format of the 
FORTRAN statement Is: 

1. . .5. ..10. . .15. . .20. . .25. . .30. . .35. . .i*0. . .45. . .50. . .55. . .60 
CALL SDVICE (ARG1,ARG2,ARG3) 



ARGl 
ARG2 
ARG3 



Is a fixed point number and specifies any legal 
device code number. 

is a fixed point number and specifies any legal 
device code number. 

Is a fixed point quantity and represents the datum 
to be transmitted to the A register. 



ARGl and ARG2 specify a range of device codes such that If during 
simulation of an Input/output instruction^ a device code is 
generated which is within the range, then the ARG3 datum is 
transmitted to the A register. 
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6.5.6 SID REQUEST 



The SIC request may be issued by the FCP and the service supplied 
by the Simulator Is to logically connect an I/O device code to 
the name of a FORTRAN subroutine to be invoked when data is to be 
transmitted or received on that channel. This service permits 
the user to define and connect models of external devices and 
thereby permits inputting and/or outputting to/from the A 
register (under format control) or memory (under format control). 
Refer to Section 5 for a description of the 10 control block and 
to Section 7 for the I/O model specification. The Simulator 
diagnostic action and the setting of the ERRFLG indicator are 
specified in Table 5-11. The format of the FORTRAN statement is: 

1. . .5. . .10. . .15. ..20...25...30...35...«t0...tf5...50...55...60 
CALL SIO (ARG1;ARG2,ARG3) 

ARGl is a fixed point quantity and specifies the starting 
number of a range of device codes. 

ARG2 Is a fixed point quantity and specifies the ending 
number of a range of device codes. 

ARG3 is a fixed point quantity and specifies the number 
of the FORTRAN subroutine to be invoked when a 
device code in the range given by ARGl and ARG2 
is specified in an input/output instruction. 

The number used in ARG3 is the integer portion of the subroutines 
MODO through MOD80 which are supplied as dummy subroutines and 
are over-ridden by the user supplied MODO through MOD80 as 
defined by SIO. 
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6.5.7 SMEMRY REQUEST 



The SMEMRY request may be Issued by the FCP and the service 
supplied by the Simulator is to evaluate the input symbol and 
return the SKC3120 absolute address. The SMEMRY request is a 
statement function and thus differs from other subroutine 
services. The SMEMRY service permits the user to perform 
symbolic arithmetic and logic operations using the PC and the 
OAR/ elements of the CPU control blocl<. The Simulator diagnostic 
action and setting of the ERRFLG Indicator are presented in Table 
5-11. The format of the FORTRAN statement is: 

1. . .5. . .10. ..15. . .20. . .25. . .30. . .35. ..40. . .«i5. ..50. . .55. . .60 
ASSIGN = SMEMRY (ARG1/ARG2) 

* 

ARGI Is a double-word character string specifying the 
deckname. 

ARG2 Is a character string array and specifies the 
symbol to be evaluated. 

The ARG2 array must be a single subscripted array of dimension 
(h). Both symbols must be left-justified and padded with blanks 
on the right. 
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6.5.8 SSETA REQUEST 



The SSETA request may be Issued by the FCP and the service 
supplied by the Simulator Is to set the A register as a function 
of the user specified conversion type and record the results of 
the operation. The type of conversion permited Is none or host 
machine floating point to SKC3120 fixed point. The Simulator 
diagnostic action and the setting of the ERRFLG indicator are 
specified in Table 5-11. The format of the FORTRAN statement is: 

1. . .5. . .10. . .15. ..20. .. 25. ..30. ..35. ..i*0. ..i+S. ..50. ..55. . .60 
CALL SSETA (ARGl, ARG2, ARG3) 

ARGl Is a ful 1 -word character string and specifies the 
type of conversion desired; the following values 
are permitted: 

"HEX " No conversion. 

••fix " ARG2 and ARG3 must be host machine floating 
point scalars/ where ARG3 represents the 
scale factor of the LSB of the resulting 
fixed point quantity. 

"FLT " ARG2 must be a double precision floating 
point quantity. When "FLT " option is 
specified, the conversion is from host 
machine floating point to SKC3120 floating 
point. 

ARG2 is the host machine floating or fixed point 
quantity to be input. 

ARG3 is a fixed point quantity and represents the LSB 

value of the conversion from host machine floating 
point to SKC3120 fixed point. 
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6.5.9 SSETB REQUEST 



The SSETB request is identical to the SSETA request except that 
the B register receives the result of the conversion. Refer to 
Section 6.5.8, SSETA request. 
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6.5.10 SSETX REQUEST 



The SSETX request may be issued by the FCP and the service 
supplied by the Simulator is to set the index register and record 
the results of the service operation. The Simulator diagnostic 
action and the setting of the ERRFLG Indicator are specified in 
Table 5-11. The format of the FORTRAN statement Is shown below: 

1...5...10...15...20...25...30...35...U0...i*5...50...55...60 
CALL SSETX (AR61) 

ARGl is a fixed point scalar quantity which is to be 
loaded Into the index register, XR. 
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6.5.11 SCHECK REQUEST 



The SCHECK request may be Issued by the FCP and the service 
supplied by the Simulator Is to record on secondary storage the 
state of the simulated SKC3120 machine for subsequent restart. 
The format of the FORTRAN statement Is shown below. There are no 
arguments. 

1. . .5...10. . .15. . .20. . .25. . .30. ..35. . .IjO. . .«45.f .50. . .55. ..60 
CALL SCHECK 
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6.5.12 SRESTR REQUEST 



The SRESTR request may be Issued by the FCP and the service 
supplied by the Simulator Is to re-lnl t lal Ize the SKC3120 
machine to the state It had at the time of the previous 
checkpoint. The Simulator diagnostic action and the setting of 
the ERRFLG indicator are specified In Table 5-11. The format of 
the FORTRAN statement Is shov^n below. There are no arguments. 

1. . .5. ..10. . .15. . .20. . .25. . .30. . .35. . .1*0. . .t*5. . .50. . .55. ..60 
CALL SRESTR 

6.5.13 STAPIN REQUEST 



The STAPIN request may be Issued by the FCP and the service 
supplied by the Simulator Is to perform a computer memory load; 
I.e., load the memory with the operational program residing on 
secondary storage. The Simulator diagnostic action and the 
setting of the ERRFLG Indicated are specified In Table 5-11. The 
format of the FORTRAN statement Is shown below. There are no 
arguments. 

1. . .5. . .10. . .15. . .20. . .25. ...30. . .35. . .lifO. . .45. . .50. . .55. ..60 
CALL STAPIN 
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6.5. li* SNOTE REQUEST 



The SNOTE request may be Issued by the FCP and the service 
supplied by the Simulator Is to record a user specified message. 
The format of the FORTRAN statement is: 

1. . .5. . .10. . .15. . .20. . .25. . .30. . .35. . .^0. . .'*5. ..50. ..55. ..60 
CALL SNOTE (ARG1,ARG2) 

ARGl is a fixed point quantity and specifies the number 
of characters in ARG2. 

ARG2 is a character string and specifies the message to 
be recorded. 
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6.5.15 STABLE REQUEST 



The STABLE request may be issued by the FCP and the service 
suppMed by the Simulator is to evaluate the input array of 
symbols and return the corresponding SKC3120 absolute addresses. 
The Simulator diagnostic action and setting of the ERRFLG 
statement are presented in Table 5-il. The format of the FORTRAN 
statement is: 

..10...15...20...25...30...35...lf0...i*5...50...55...60 
CALL STABLE (ARGl, ARG2, ARG3, ARQi^) 

is a fixed point quantity and specifies the ARG3 
and ARG^ array sizes. 

is a double-word character string (8 characters) 
and specifies the deckname. 

is a character string array and specifies the 
symbols to be evaluated. 

is a fixed point array of SKC3120 absolute 
addresses. 

ARG3 must be a double subscripted array of dimension (tf^ARGl). 
All symbols must be left-justified and padded with blanks on the 
right. 



1...5 


ARGl 


ARG2 


ARG3 


ARGU 
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6.5.16 



SSETR REQUEST 



The SSETR request may be issued by the FCP and the service 
supplied Is to set the user specified CPU register (i.e. Base 
register 1, 2, or the inactive Index register) and record the 
results of the service operation. The simulator diagnostic 
action and the setting of the ERRFLG Indicator are specified In 
table 5-IJ. 

1. . .5. . .10. . .15. . .20. ..25. ..30. . .35. ..ifO. . .^5. . .50. ..55. ..60 
CALL SSETR (ARG1,ARG2) 



ARGl 



Is a fixed point scalar quantity which specifies 
the selected CPU register, permlssable ARGl values 
are presented In Table 6-1 V. 



Is a fixed point scalar quantity which is to be 
loaded Into the selected CPU register. 



ARG2 

"ABLE 6-IV ARGl SETTINGS 

4. . , , • . -.- 

I ARGl Value I Interpretation 

+ •-.--«-.-.' . • 



3 
k 
5 



I Base register one selection 

I 

I Base register two selection 

I 

I Inactive index register selection 



+ ^««« + 
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7. 



70 MODEL LANGUAGE SPECIFICATION 



7.1 MODEL LINKAGE 

The model names of the user defined external device 

presented In Table 7-1. The mechanism that must be 

the user to Inform the Simulator that dynamic simulation is 

desired is the SIO service request. Issuance of the SIO request 

results In the Simulator action of logically connecting 

specified SIO device codes to the name of the FORTRAN model. 

7.2 MODEL CONTROL FUNCTIONS 



models are 
exercised by 



the 



All control functions that are permitted In the FCP are 
permlssable In the user models. Refer to Section S.k^ FCP 
Control Functions. 

7.3 MODEL SERVICE REQUESTS 



All services provided In the FCP 
models. Refer to Section 6.5/ FCP 



are available in 
Service Requests. 



the user 



TABLE 7-1 MODEL NAMES 



Subroutine 
Model Names 



Function 



MODI 
M0D2 



M0D63 
M0D64 
MOD 6 5 
MOD66 



MOD 80 



I/O model 
I/O model 



I/O model 
I/O model 
I/O model 
I/O model 



I/O model 



Invoked 
Invoked 



by 
by 



level 
level 



Interrupt 
Interrupt 



F4202-I 2/75 



7-1 



V 9 1, n A X n f4 n Q 1 n THE SINGER COMPANY 

Y2i|0A302M0810 p^y - KEARFOTT DIVISION 



A maximum of 80 I/O model subroutines are perml tted^but Models 
MOD64 and M0D65 are called uncondi tibnal ly In the event that a 
level 1 or level 2 Interrupt occurS/ respectively. MODS'* and 
M0D65 are automatically connected and thus need not be specified 
In an SIO request, however, if any additional processing Is 
required because of the Interrupt occurrence, that processing may 
be Included v^lthln a lAODSk or M0D65 1/0 model supplied by the 
user. 
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APPENDIX A 
Default FCP Program Listing 
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APPENDIX A 



C 
C 

C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 



C 
C 
C 
C 
C 

c 
c 
c 



DEFAULT FORTRAN CONTROL PROGRAM (FCP) 

SUBROUT I NE CONTRL( BS I ZE, ET I ME, COUNT^ CONDFG ) 

FORTRAM CONTROL PROGRAM - CONTRL 
ENVIRONMENT AND LANGUAGE SPECIFICATIONS 



BSIZE 

BRKLST 

ET I ME 

COUNT 

CONDFG 

CONDFG 



LSB=1 US 



SIZE OF ARRAY BRKLST 
BREAK POINTS 
ELASPSED TIME, SCALE 
INSTRUCTION COUNT 
CONDITION FLAG 

1 INDICATES ERROR CONDITION 

2 INDICATES REAL TIME CLOCK INTERRUPT 

3 INDICATES ELAPSED TIME INTERRUPT 

k INDICATES INSTRUCTION COUNT INTERRUPT 
5 INDICATES BREAK POINT INTERRUPT 



BLOCK ALLOCATION 

DIMENSION SERV(25),ACTION(25),NODCK(2),KARD(20) 

DIMENSION MASK(5),ETIME(2) 

DIMENSION ADDR(25), ISDATA(25),ASCALE(25) 

DIMENSION RSDATA(1),RESULT(1) 

EQUIVALENCE ( I SDATAC 1 ), RSDATAC 1) ), { I SDATA(l), RESULT(l) ) 

COMMON/MEMORY/ S I MMEM ( 163 8 «* ) 

COMMON BLOCK NAME=MEMORY 



NAME 
SI MM EM - 



DEFINTI 
SIMULATED 



ON 
MEMORY 



(DEFAULT 16K FULL WORDS) 



COMMON/ I ODEF/ I RTCLK,MEMSPD 
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C 

c 
c 
c 
c 
c 



c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 

c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 



COMMON BLOCK NAME=IODEF 

NAME DEFINITION 

IRTCLK - REAL TIME CLOCK PERIOD, SCALE LSB=1 US (DEFAULT 0) 
MEMSPD - SPEED OF MEMORY IN NANO-SECONDS (DEFAULT 1228) 

COMMON/CPU/A, B, PC, PCOLD, C, D, CBO, OAR, I R, SR, I MR, XR, PSEU1(3 ) , 
t B1,B2, IXR,PSEU2(57),SWR,TIME(2),ERRFLG,INTFLG,TRCFLG,TRMFLG 

COMMON BLOCK NAME«CPU 

NAME DEFINITION 
A - A-REGISTER 
B - B-REGISTER 
PC - UPDATED PROGRAM COUNTER 
PCOLD - CURRENT PROGRAM COUNTER 
C - C-REGISTER 
D - D-REGISTER 

OAR - OPERATION ADDRESS REGISTER 
IR - INSTRUCTION REGISTER 
SR - STATUS REGISTER 
IMR - INTERRUPT MASK REGISTER 
XR - INDEX REGISTERS (6«i) 
SWR - SWITCH REGISTER 
TIME - ELAPSED TIME IN MICRO-SECONDS 
ERRFLG - ERROR INDICATOR 
INTFLG - INTERRUPT FLAGS 
TRCFLG - TRACE FLAG 
TRMFLG - TERMINATION FLAG 

COMMON/IO/LFLAG,COMMND,ACK,TMEDLY,INOUT, LOC,DATA,DC 

COMMON BLOCK NAME»IO 

NAME DEFINTION 

LFLAG - LONG OR SHORT INSTRUCTION 

LFLAG = A REGISTER OPERATION 

= 1 MEMORY OPERATION 
COMMND - COMMAND BIT 
ACK - ACKNOWLEDGE BIT 
TMEDLY - TIME DELAY 

INOUT - INDICATES INPUT OR OUTPUT OPERATION 
INOUT = INPUT OPERATION 

= 1 OUTPUT OPERATION 
LOC - MEMORY LOCATION (HALF WORD ADDRESS 
DATA - DATA TRANSMITTED IN OR OUT 
DC - DEVICE CODE 
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C 
C 

c 

c 

C 
C 
C 

c 



COMMON BLOCK NAME=BLIST 



C 
C 
C 



NAME DEFI 
BRKLST - LIST 



NITION 
OF BREAK 



POINTS 



EXPLICIT TYPE DECLARATIONS 

INTEGER A, ACTION, ADDR,ACK,ACTCMD 

INTEGER B, BRKLST, BSIZE, BLNK , 81, B2 

INTEGER C,CBO, CORSTP, CORSTR, COUNT, CONDFG,COMMND 

INTEGER D, DMPSTR, DMPSTP, DCK, DUMPSR, DUMPSP,DATA,DC 

INTEGER !IED,HEXDAT 

INTEGER ERRFLG,ETIME,ENDCD 

INTEGER OAR,ONOFF 

INTEGER PCOLD, PC, PCLOG, PSEUl, PSEU2 

INTEGER RAMSTR, RAMSTP, ROMSTR, ROMSTP 

INTEGER SIMMEM, SR, SRMSK, SWR, SYMBOL 

INTEGER START, STOP, SHORTL 

INTEGER TIME, TRCFLG, TRMFLG, TERM, TMEDLY, TMP1(8), TMP2(8) 

INTEGER XR 

DOUBLE PRECISION SERV, REQST, FLT, RDDATA(25 ) 



DATA DEFINITIONS 

DATA SERV/8H$I0DEF ,8H$BREAK 

* 8H$N0TE ,8H$DUMP 

* 8H$INPUTFL,8H$0UTPTHX 

* 8H$TRACE ,8H$CHECK 

* 8H$EXEC ,8H$CHKSM 

* 8H$SETAFL ,8H$SETBHX 

* 8H$SETR / 
DATA ENDCD/JiHEND /,BLNK/ltH 
DATA MASK/1, 2, U, 8, 16/ 
DATA NODCK/i+HNODE,lfHCK / 
DATA MDFLAG/0/ 

ICNT =0 
610 ICNT = ICNT + 1 

IFdCNT.GT.S) RETURN 

IF( IAND( MASK(ICNT), CONDFG ) 
600 GO TO (1000, 2000, 3120, 4000, 
1000 CONTINUE 



,8H$INTRPT ,8H$TAPIN , 
, 8H$ I NPUTHX, 8H$ I NPUTFX, 
, 8H$0UTPTFX, 8H$0UTPTFL, 
,8H$RESTR ,8H$TERM 
,8H$SETAHX ,8H$SETAFX , 
,8H$SETBFX ,8H$SETX 

/,TERM/I|HTERM/ 



.EQ. ) GOTO 
5000), ICNT 



610 



C 
C 
C 



ERROR CONDITION PROCESSING 



IF(ERRFLG.EQ.32)GOTO 9001 
IF(ERRFLG.EQ.I|I*)GOTO 9002 

IF(ERRFLG.GE.76.AND.ERRFLG.LE.lll)GOTO 9003 
GO TO 610 
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9001 CONTINUE 
C 

C ADDRESSABILITY ERROR 
C 

TRMFLG=1 

CALL SNOTE(33,33HTERMINATION DUE TO ADDRESSABILITY) 

RETURN 

9002 CONTINUE 
C 

C ILLEGAL INSTRUCTION 
C 

TRMFLG=1 

CALL SNOTE(38,38HTERMINATION DUE TO ILLEGAL INSTRUCTION) 

RETURN 

9003 CONTINUE 
C 

C RTA ERROR-CHANNEL ACTIVE BUT NOT CURRENT, OR INACTIVE OR PENDING 
C 

TRMFLG=1 

CALL SNOTE(36,36HTERMINATION DUE TO RTA-ADDRESS ERROR) 

RETURN 
2000 CONTINUE 
C 

C REAL TIME INTERRUPT CONDITION 
C INTFLG SET TO INITIATE REAL TIME INTERRUPT 

INTFLG=2**INTRTN 
C 

GO TO 610 
3120 CONTINUE 
C 

C ELAPSED TIME INTERRUPT 
C 

GO TO 610 
ifOOO CONTINUE 
C 

C INSTRUCTION COUNT INTERRUPT 
C 

GO TO 610 
5000 CONTINUE 
C 

C BREAK POINT INTERRUPT 
C 

IF(BSIZE.EQ.0)GOTO 1 
C 

C . COMMAND PROCESSOR 
C 



^-l^ 
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C 

C DETERMINE USER DEFINED ACTION 

C 

DO itOO KK=1,BSIZE 

IF(PC.EQ.BRKLST(KK))GOTO lj02 
UOO CONTINUE 

RETURN 
402 CONTINUE 
C 

C TERMINATION ? 
C YES, THEN GOTO TERMINATION SEQUENCE 

IF(ACTION(KK).EQ.TERM)GOTO 7500 
C NO, THEN PARSE ADDITIONAL COMMANDS 
C 

1 READ(it,200) REQST^TMPl 

LOC = IHEXCN(8,TMP1(1)) 

DO JilO J = l,25 

IF(REQST.EQ.SERV(J))GO TO 1*20 
klO CONTINUE 
C 

C COMMAND NOT RECOGNIZED, WRITE DIAGNOSTIC 
C 

WRITE(6,300) REQST,TMP1 

GO TO 1 
£t20 VmiTE(6,210) REQST,TMP1 

GOTO (6000, 6100, 6200, 6300, 61^00,6500, 6600, 6 700, 6800, 6900, 

* 7000,7100,7200,7300,7400,7500,7600,7700,7800,7900,8000, 

* 8100,8200,8300,8400), J 
C 

6000 CONTINUE 
C $IODEF - DEFINE REALTIME CLOCK INTERRUPT NUMBER 
C - DEFINE MEMORY SPEED 

C - DEFINE REAL TIME CLOCK INTERVAL PERIOD 

C 

READ(4,102)INTRTN,MEMSPD, IRTCLK 

V\JR I TE ( 6, 112 ) I NTRTN,MEMSPD, I RTCLK 

GOTO 1 
C 

6100 CONTINUE 
C $BREAK - BREAK POINT LIST DEFINITION 
C 

READ(4,104) HED,TMP1,ACTCMD 

WRITE(6,114) HED,TMP1,ACTCMD 

PCLOC = IHEXCN(8,TMP1(1)) 

IF(HED.EQ.ENDCD) GO TO 1 

CALL PCSTQP(PCL0C,ACTCMD,BSIZE,ACTI0N(1)) 

GOTO 6100 
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6200 CONTINUE 

C $INTRRPT - INTERRUPT DEFINITION 

C 

READ (4,108) (TMPl(IDX),IDX = l,lt) 
WRITE(6,118) (TMPl(IDX),IDX = l,lt) 
INTNO=IHEXCN(t»,TMPl(l)) 
INTFLG= INTNO 
GO TO 1 

C 
6300 CONTINUE 

C $TAPIN - TAPE LOAD COMMAND 

C 

C 



CALL STAPIN 
GO TO 1 



61*00 CONTINUE 
C $NOTE -SNOTE COMMAND 
C 

READ(U,101) (KARD(I), 1=1,20) 

WRITE (6, 111) KARD 

CALL SNOTE(80,KARD(1)) 

GO TO 1 
C 

6500 CONTINUE 
C $DUMP - DUMP REGION DEFINITION 
C 

READ(l|,100) HED/TMP1,TMP2 

WRITE (6, 110) HED,TMP1,TMP2 

START = IHEXCN(8/TMP1(1)) 

STOP = IHEXCN(8,TMP2(1)) 

IF(HED.EQ.ENDCD)GOTO 1 

CALL SDUMP(1,N0DCK(1), START, STOP) 

GOTO 6500 
C 

6600 CONTINUE 

C $INPUT - INPUT DEFINITION, HEX OPTION 
C 

6601 NUMBER = 

6602 READ(lf,100) HED,TMP1,TMP2 
WRITE{6,110) HED,TMP1,TMP2 
IFCHED.EQ.ENDCD) GO TO 6603 
NUMBER = NUMBER + 1 
ADDR(NUMBER) « I HEXCN(8, TMPK 1) ) 
ISDATA(NUMBER) = I HEXCN (8, TMP2( 1) ) 
IF( NUMBER .LT. 25 ) GOTO 6602 
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6603 CONTINUE 

IF( NUMBER .EQ. ) GOTO 1 

KOUNT = 1 

IDX = 1 

IF{ NUMBER .EQ. 1 ) GOTO 

DO 6610 J = 2, NUMBER 

KOUNT = KOUNT + 1 

IF( ADDR(J-l) + 1 

CALL SINPUT(I»HHEX 

KOUNT = 1 

IDX = J 
6610 CONTINUE 
6615 CALL SINPUT(tjHHEX 

IF( MED .NE. ENDCD 

GOTO 1 



6615 



. EQ. ADDR(J) ) GOTO 6610 
^N0DCK(1)^ADDR(IDX),K0UNT-1,ISDATA(IDX),DMY) 



^N0DCK(1),ADDR(IDX),K0UNT/ISDATA<IDX)^DMY) 
) GOTO 6601 



C 
C 



6700 CONTINUE 

$ INPUT - INPUT 



DEFINITION, FIX OPTION 



6701 NUMBER =0 

6702 READ(lj,106) HED,TMP1,V^0RD, SCALE 
IFCHED.EQ. ENDCD) GOTO 6703 
NUMBER = NUMBER +1 
ADDR(NUMBER) = IHEXCN(8, TMPl(l) ) 
RSDATA( NUMBER) = WORD 
ASCALE(NUMBER) = SCALE 
VmiTE(6,116) HED,TMP1/W0RD, SCALE 
IF (NUMBER .LT. 25 ) GOTO 6702 

6703 CONTINUE 

IF( NUMBER .EQ. ) GOTO 1001 

KOUNT = 1 

IDX = 1 

IF( NUMBER .EQ. 1 ) GOTO 6715 

DO 6710 J = 2, NUMBER 

KOUNT = KOUNT + 1 

IF( ADDR(J-l) + 1 .EQ. ADDR(J) ) GOTO 6710 

CALL SINPUT(ttHFIX , NODCK( 1), ADDR( I DX) , KOUNT- 

* RSDATA(IDX),ASCALE(IDX)) 
KOUNT = 1 

IDX = J 
6710 CONTINUE 
6715 CALL SINPUTCfHFIX ,N0DCK(1), ADDR( I DX), KOUNT, 

* RSDATA(IDX),ASCALE(IDX)) 

IF( HED .NE. ENDCD ) GOTO 6701 
GOTO 1001 



1. 
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6800 CONTINUE 

C $INPUT - INPUT DEFINITION^ FLT OPTION 
C 

6801 NUMBER = 

6802 READ(U^107) HED,TMP1,FLT 
IF(HED.EQ.ENDCD) GOTO 6803 
NUMBER = NUMBER + 1 
ADDR(NUMBER) = I HEXCN(8, TMPK 1) ) 
RDDATA(NUMBER) = FLT 
WRITE(6,H7) HED^TMPl^FLT 

IF( NUMBER .LT. 25 ) GOTO 6802 

6803 CONTINUE 

IF( NUMBER .EQ. ) GOTO 1001 

KOUNT =1 

IDX = 1 

IF( NUMBER .EQ. 1 ) GOTO 6815 

DO 6810 J = 2^ NUMBER 

KOUNT = KOUNT + 1 

IF( ADDR(J-l) + 2 .EQ. ADDR(J) ) GOTO 6810 

CALL SINPUT(«iHFLT , N0DCK(1)^ADDR( I DX), KOUNT-1^ RDDATA( I DX),DMY) 

KOUNT = 1 

IDX » J 
6810 CONTINUE 
6815 CALL SINPUT(i*HFLT , NODCK(l), ADDR( I DX)^ KOUNT^ RDDATACI DX)^DMY) 

IF( HED .NE. ENDCD ) GOTO 6801 

GOTO 1001 
C 

6900 CONTINUE 

C $OUTPT - OUTPUT DEFINITION, HEX OPTION 
C 

6901 NUMBER = 

6902 READ(l»,100) HED^TMPl 
WRITE(6,1101) HED.TMPl 
IF(HED.EQ.ENDCD)GOTO 6903 
NUMBER = NUMBER + 1 
ADDR(NUMBER) = I HEXCN(8,TMP1(1) ) 
IF( NUMBER .LT. 25 ) GOTO 6902 

6903 CONTINUE 

IF( NUMBER .EQ. ) GOTO 1 

KOUNT = 1 

IDX = 1 

IF( NUMBER .EQ. 1 ) GOTO 6915 

DO 6910 J = 2, NUMBER 

KOUNT = KOUNT +1 

IF( ADDR(J-l) +1 .EQ. ADDR(J) ) GOTO 6910 
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CALL SOUTPT(t*HHEX ^ NODCKC 1), ADDR( I DX), KOUNT-1, I SDATA( I DX) ,DMY) 

KOUNT =1 

IDX = J 
6910 CONTINUE 
6915 CALL SOUTPT(»fHHEX , NODCK( 1) , ADDR( I DX) , KOUNT^ I SDATAC I DX), DMY) 

IF( MED .NE. ENDCD ) GOTO 6901 

GOTO 1 
C 

7000 CONTINUE 

C $OUTPT - OUTPUT DEFINITION, FIX OPTION 
C 

7001 NUMBER = . 

7002 READ(Ij, 106) HED.TMPl, SCALE 
IF(HED.EQ.ENDCD) GOTO 7003 
NUMBER = NUMBER + 1 
ADDR(NUMBER) = I HEXCN{8, TMPK 1) ) 
ASCALE(NUMBER) = SCALE 
imiTE(6, 1161) HED.TMPl, SCALE 

IF( NUMBER .LT. 25 ) GOTO 7002 

7003 CONTINUE 

IF( NUMBER .EQ. ) GOTO 1001 

KOUNT = 1 

IDX = 1 

IF( NUMBER .EQ. 1 ) GOTO 7015 

DO 7010 J = 2, NUMBER 

KOUNT = KOUNT + 1 

IF( ADDR(J-l) + 1 .EQ. ADDR(J) ) GOTO 7010 

CALL SOUTPT(l»HFIX ,NODCK( 1), ADDR( I DX) , KOUNT-1, 

* RSDATA(IDX)yASCALE(IDX)) 
KOUNT =1 

IDX = J 
7010 CONTINUE 
7015 CALL SOUTPTCtHFIX , NODCK( 1), ADDRC I DX) , KOUNT, 

* RSDATA(IDX),ASCALE(IDX)) 

IF( HED .NE. ENDCD ) GOTO 7001 
GOTO 1001 
C 

7100 CONTINUE 

C $OUTPT -OUTPUT DEFINITION, FLT OPTION 
C 

7101 NUMBER =0 

7102 READ(tt,100) HED,TMP1 
IF(HED.EQ.ENDCD)GOTO 7103 
NUMBER = NUMBER +1 
ADDR(NUMBER) = I HEXCN(8,TMP1( 1) ) 
VVRITE(6,11Q1) HED,TMP1 

IF( NUMBER .IT. 25 ) GOTO 7102 
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7103 CONTINUE 

IF( NUMBER .EQ. ) GOTO 1001 

KOUNT = 1 

IDX = 1 

IF( NUMBER .EQ. 1 ) GOTO 7115 

DO 7110 J = 2, NUMBER 

KOUNT = KOUNT +1 

IF( ADDR(J-l) + 2 .EQ. ADDR(J) ) GOTO 7110 

CALL SOUTPT(l*HFLT ^ NODCK( 1) ^ ADDR( I DX) , KOUNT-1, RDDATA( I DX),DMY) 

KOUNT =1 

IDX = J 
7110 CONTINUE 
7115 CALL SOUTPT(ltHFLT ,N0DCK(1)> ADDR( I DX),KOUNT^RDDATA( I DX), DMY) 

IF( HED .NE. ENDCD ) GOTO 7101 , 

GOTO 1001 
C 

7200 CONTINUE 
C $TRACE - TRACE COMMAND 
C 

READ(tt,103) ONOFF 

WRITE(6,113) ONOFF 

TRCFLG = ONOFF 

GO TO 1 
C 

7300 CONTINUE 
C $CHECK -CHECK POINT COMMAND 
C 

CALL SCHECK 

GOTO 1 
C 

7U00 CONTINUE 
C $RESTR - RESTART COMMAND 
C 

CALL SRESTR 

GOTO 1 
C 

7500 CONTINUE 
C $TERM - TERMINATION COMMAND 
C 

TRMFLG=1 

RETURN 
C 

7600 CONTINUE 
C $EXEC - EXECUTE SIMULATOR, START AT PC 
C 

IF(LOC.NE..O)PC=LOC 

RETURN 



A-10 

F4202-I 2/76 



THE SINGER COMPANY Y2UQA302M0810 

KEARFOTT DIVISION YZU0A:SUZMU810 ^gy 



C 

7700 CONTINUE 

C $CHKSM - CHECKSUM COMMAND 

C 

C 

C 
C 



CALL SCHKSM(LOC) 
GO TO 1 

7800 CONTINUE 
C $SETAHX - SET A REGISTER, HEX OPTION 

READ(t»,100) HED.TMPl 

VVRITE(6,110) HED.TMPl 

DATA = IHEXCN(8,TMP1(1)) 

CALL SSETA(UHHEX ,DATA,DMY) 

GOTO 1 
C 

7900 CONTINUE 
C $SETAFX - SET A REGISTER, FIX OPTION 
C 

READ(«*,120) HED, WORD, SCALE 

WRITECe, 121) HED, WORD, SCALE 

CALL SSETA(ltHFIX , WORD, SCALE) 

GOTO 1 
C 

8000 CONTINUE 
C $SETAFL - SET A REGISTER, FLT OPTION 
C 

READ(l»,122) HED,FLT 

WRITE(6,123) HED,FLT 

CALL SSETA(liHFLT ,FLT,DMY) 

GOTO 1 
C 

8100 CONTINUE 
C $SETB - SET B REGISTER, HEX OPTION 
C 

READ(lt,100) HED,TMP1 

WRITE(6,110) HED,TMP1 

DATA = IHEXCN(8,TMP1(1)) 

CALL SSETB(1jHHEX ,DATA,DMY) 

GOTO 1 
C 

8200 CONTINUE 
C $SETB - SET B REGISTER, FIX OPTION 
C 

READ(lt,120) HED, WORD, SCALE 

imiTE(6,121) HED, WORD, SCALE 

CALL SSETBUhFIX , WORD, SCALE) 

GOTO .1 
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C 

8300 CONTINUE 
C $SETX - SET XR REGISTER 
C 

READ(If,100) HED, TMPl 

WRITE(6^110) HED^ TMPl 

DATA = IHEXCN(8,TMP1(1)) 

CALL SSETX(DATA) 

GOTO 1 
C 

8lf00 CONTINUE 
C $SETR - SET CPU REG I STERS(B1, B2^ IXR) 

C 

READ(U,12U) HED, NUMBER, TMPl 

WRITE (6, 125) HED, NUMBER, TMPl 

DATA = IHEXCN(8,TMP1(1)) 

CALL SSETR(NUMBER,DATA) 

GOTO 1 
1001 WRITE(6,1102) HED 

GOTO 1 

100 FORMAT (AI*,2(1X,8A1)) 

101 F0RMAT(20AJt) 

102 FORMAT ( I 2, IX, U, IX, 1 10) 

103 FORMAT(ll) 

101* FORMAT (AU,lX,8Al,lX,AJt) 

105 FORMAT (8A1) 

106 FORMAT (Alj, IX, 8A1, 2(lX,Ellf. 7) ) 

107 FORMAT (AI*, IX, 8A1, IX, D22. ) 

108 FORMAT (UAl) 

109 FORMAT (2(1 2, IX)) 

110 F0RMAT(lX,Alj,2(lX,8Al)) 

111 FORMAT(1X,20AU) 

112 FORMAT (IX, 12, IX, U, IX, 110) 

113 F0RMAT(1X,I1) 

lUi F0RMAT(1X,AI*, lX,8Al,lX,Alt) 

116 FORMAT(lX,Atj,lX,8Al,2(lX,Eli*.7)) 

117 F0RMAT(1X,AU, IX, 8A1,1X, 022.15) 

118 FORMAT(lX,itAl) 

119 FORMAT (1X,2(I2,1X)) 

120 FORMAT (Al», 2(1X, EUt. 7) ) 

121 FORMAT (lX,AIt,2(lX,ElU.7)) 

122 FORMAT (Atj, 1X,D22. 0) 

123 FORMAT (IX, Atj, D22. 15 ) 
12l» FORMAT (Alf,lX, I2,1X,8A1) 
125 FORMAT (IX, AU, IX, I 2, IX, 8A1) 
200 FORMAT (A8,1X,8A1) 

210 F0RMAT(1X,A8,1X,8A1,87X,18HC0MMAND RECOGNIZED) 
300 F0RMAT(1X,A8,1X,8A1,87X,17HUNDEFINED REQUEST) 
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1101 F0RMAT(lX^Aij,lX,8Al) 

1102 FORMATClX^Aij) 

1161 F0RMAT(1X,A1*,1X^8A1,1X^E1IJ.7) 
9999 STOP 

END 

SUBROUTINE PCSTOPCPCLOC, ACT/BSI ZE^ACTN) 

DIMENSION ACTN(1),TYPE(3) 

COMMON/BLIST/BRKLSTCl) 

I NTEGER PCLOC^ ACT, BS I ZE, BRKLST, ACTN, TYPE 

DATA TYPE/I»H ,l»HTERM,«tHDLTE/ 

IF(BSIZE.EQ.0)GOTO 15 

DO 10 l=l,BSIZE 

IF(PCLOC.EQ.BRKLST(l))GO TO 20 
10 CONTINUE 
15 BSIZE=BSIZE+1 

IDX = BSIZE 

IF(BSIZE.GT.25)RETURN 

BRKLST(IDX) = PCLOC 

GO TO 30 
20 IDX = I 
30 DO kO 1=1,3 

IF(ACT.EQ.TYPE(l))GO TO 50 
kO CONTINUE 

ACTNdDX) = TYPE(l) 

RETURN 
50 GO TO (1,2,3), I 

1 ACTN(IDX) = TYPE(l) 
RETURN 

2 ACTN(IDX) = TYPE(2) 
RETURN 

3 BRKLSTCIDX) = BRKLST(BS I ZE) 
ACTN(IDX) = ACTN(BSIZE) 
BRKLST(BSIZE)«0 
BSIZE=BSIZE-1 

RETURN 
END 
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APPENDIX B 
Operation of the Simulator In Alternate Configurations 
B 1 CONFIGURATION SELECTION 



This manual may also be used to simulate other available SKC3120 
series computers. The Simulator requires a 'Target Machine 
Configuration File' for Initialization. This file is transparent 
to the user but must be selected for the target machine as 
described In the Host Procedures Manual. The format of the 
'Target Machine Configuration File' Is described in the 
Assembler/Llnkage/Edi tor/Slmulator Users Manual. 

B 2 MEMORY CONTROL BLOCK 



The MEMORY control block may be employed by the user to override 
the default memory size of 16K words. The size of the memory 
model is specified by the dimension of the SIMMEM array. The 
width of the memory is one full-word of the host machine, which 
is sufficiently large to accommodate 15-, 16- or 19-bit word 
lengths of the simulated SKC3120 Computer. Table 5-IV presents 
the information content of the MEMORY control block. 

B 3 SIMULATOR DIAGNOSTICS 



Simulator diagnostics are Identical to those described In Table 
5-11 except invalid conversion diagnostics will be generated If 
the value exceeds the limits -2**16 LE x LE (2**16)-1 for 16 bit 
data words and -2**19 LE x LE (2**19)-1 for 19 bit words. 
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COMMENTS AND EVALUATIONS 

Your evaluation of this document is welcomed by the Singer Company* 

Any errors/ suggested corrections or general comments may be made 
and continued on the reverse side. Please Include page number and 
reference paragraph and forward to: 

The Singer Company 

Aerospace and Marine Systems 

Kearfott Division 

150 Totowa Road 

Wayne^ New Jersey 07^*70 

Attention: Department 5760 



Name 

Company Affiliation 

Address 



Comments: 
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